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THE CHALLENGE: You have just seated yourself in an ultra-sleek inter- ! | 

galactic space fighter. Red Alert! Your craft is catapulted out through the launch 

bay doors into an ultra-hostile environment. YOUR MISSION: Survive the . **jb 

onslaught of robot drones, ground attack craft, and enemy fighters through ten f\fi^ 

fantastic sequences of escalating danger. Withstanding this, you must enter the 

Starbase Trench, fly through its tunnels, avoid all barriers, and destroy the m 

Starbase Power Generator— provided your ship has enough energy remaining! ' .,. ™— .... ™„, 

THE RESULT: A masterpiece of 3-dimensional graphics, awesome sound . „ Su " e ? 

„ . . . r or Canoga Par 

effects, intense drama, and treachery at every turn. (e 

Another great game from the makers of the smash hit HARRIER STRIKE MISSION:' 
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A GEM™ among ST drawing programs. Very 
friendly, but very powerful design and painting 
program. A must for everyone's artistic or 
graphics needs. Use up to three windows. 
Cut & paste between windows. Free-form 
sketching; lines, circles, ellipses, boxes, text, 
fill, copy, move, zoom, spray, paint, undo, 
help. Double-sized picture format. $79.95 



Express yourself with PaintPro, the GEM- 
based, full-page graphics design package. 
Multiple windows. Cut & paste between 
windows. Free-form sketching; lines, circles, 
boxes, text, fill, zoom, undo, rotate, Invert, 
help. Edit fill and line patterns. $49.95 

PaintPro Library #1~hundreds of clip art 
pictures, 5 GDOS fonts. Fills 3 disks. $29.95 



Wordprocessor with professional features 
and easy-to-use! Full-screen editing with 
mouse or keyboard shortcuts. High speed 
input, scrolling and editing; sideways printing; 
multi-column output; flexible printer install- 
ation; automatic index and table of contents; 
up to 180 chars/line; 30 definable function 
keys; metafile output; much more. $49.95 
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ST Fllik Drives - Intlda and Out ^ INTERNALS 3D Graphics Programming 

$1 UiSK UrlVeS insiaeana UUt Essen tial and valuable information (or FANTASTICI Rotate about 

Includes Chapters On fifes, file Structures th8 professional programmer and ST any axis, zoom in or out, and 

and data management. Thoroughly novice. Detailed descriptions ot the shade 3D objects. Programs 

dlSCUSSeS floppy disks, hard disks and sound and graphics chips, internal written in machine language 

RAM disks from a programming and a hardware, I/O ports, using GEM, (commented) tor high speed, 

turhnical rarRrwtiVft ^oworal fuN-tpnnlh E * stem varisbles . interrupt instruct- Learn the theory behind 3D 

lecnntcai perspective, several tun lengtn j0 error codes Comrnemed B | 0S gra phics: shading, hidden 

Utilities and tools to further explore foe | i8t j n g. Arl md.soensible reference tor lino removal. With 3D pattern 
ST disk drives. 450pp $24.95 your ST library. 450pp $19.95 maker 4 animator. $24.95 

Optional diskettes are available for $14.95 each. 

Phone (616) 241-5510 
Telex 709-101 .Fax (616) 241-5021 



ST TRICKS & TIPS GEM Progr .minor's Ret. 

Fantastic collection ol pro- For serious programmers 
grams and inlo tor the ST. needing detailed information 
Complete programs include: on GEM. Presented In an 
super-last RAM disk; time- easy -to- understand format, 
saving printer spooler; color All examples in C and 
print hardcopy; plotter output assembly language. Cover* 
hardcopy; creating access- VDI and AES function*. No 
ories. Money saving tricks serious programmer should 
and tips. 260pp $19.95 bs without. 410pp $19,95 

Atari and Atari ST are trademarks of Atari Corp. 
GEM ib a trademark of Digital Research Inc. 
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P.O. Box 7219 Dept. A4 Grand Rapids, Ml 49510 



Other software and books also available. Call or 
write for your free catalog or the name of your 
nearest dealer. Or you can order directly using your 
Visa, MC or Amex. Add $4.00 per order for shipping 
and handling. Foreign orders add $12.00 per item. 
30-day money back guarantee on software. Dealers 
inquires welcome — over 2000 dealers nationwide. 
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MARK WILLIAMS C. 

AN ENLIGHTENING DEVELOPMENT 

FOR MI ST USERS. 



If you've tried your hand at 
developing applications on the Atari 
ST, you know the problem. Pro- 
gramming tools aren't only hard to 
come by, they're hard to use. One 
might even say primitive. But now 
for some enlightening news: you 
can have all the power, portability 
and versatility of the C language 
from a leader in professional C pro- 
gramming tools, Mark Williams. 

BRING YOUR 
PROGRAMMING UP TO SPEED. 

The Mark Williams C compiler "#JCfc , 

produces fast, dense code and supports the ^> t 
complete Kernighan &, Ritchie industry stan- 
dard C. You'll have access to GEM's AES and VDI 
libraries for programs using graphics, icons and the 
Atari mouse. And Mark Williams C lets you take 
advantage of the full 16 megabytes in Atari's 68000 
microprocessor 

STREAMLINE DEVELOPMENT 
WITH POWER UTILITIES. 

Mark Williams C is loaded with everything you'll 
need for professional development. Bring the power 
of the UNIX environment to your Atari ST with our 



NEW VERSION 2.0 FEATURES 




* 50% faster compile time 
+ Improved code: 20% faster 

dhrystone 

* Full access to AES/VDI libraries 
now with 200 new pages of 
documentation and dozens of 
examples 

* New integrated edit-compile 
cycle; editor automatically 
points to errors 

* Source and object code for 
RAM disk cuts compile lime 
in half 

* Complete Kernighan & Ritchie 
C plus extensions 

* Microshell Command Processor, 
a powerful UNIX style shell 

MARK WILLIAMS C FOR THE ATARI ST: $179.95 
60 DAY MONEY BACK GUARANTEE 
"Sieve benchmark from Byte, 1983. done on one double-sidetf Happy disk and included RAM 



■ MicroEMACS Full Screen Editor 
with commented source code 

• Make Program Building Discipline 

• Complete symbolic debugger 

• Assembler, linker and archiver 

• Powerful Utilities Package: one-step 
compiling/linking with cc command, 
egrep, sort, diff and more 

• Over 600 pages of documentation 
including 120 sample C programs 

• Mot copy protected 

Sieve benchmark': 

Compile and link lime in seconds. 

Mark Williams C 46,0 

Megamax 78.5 



Microshell Command Processor 
including pipes, I/O redirection and 
more. Edit your program with the 
highly acclaimed MicroEMACS full 
screen editor. Accelerate and simplify 
compiling with make which finds 
and recompiles only those modules 
affected by your changes. Then, 
when you're ready for debugging, 
call on our db Symbolic Debugger 
with single step, breakpoint and 
stack traceback functions. Over 40 
commands, including a linker and 
assembler, provide a total development 
package for your Atari ST. 

DEPEND ON A NAME WITH 
A HISTORY OF PERFORMANCE. 

Mark Williams C for the Atari ST is part of our growing 
line of C compilers. A line that includes the C compiler 
chosen by DEC, Intel, Wang and thousands of profes- 
sional programmers. Now our Atari C compiler is 
earning its own reputation: 

"Finally a great C compiler that exploits the power 
of the ST"-Sigmund Hartmann, President, Atari 
Software Group 

"The all-around best choice for serious software 
development on the ST."-Douglas Weir of ANALOG 
COMPUTING 

GET WHAT YOUR ATARI ST HAS BEEN 
WAITING FOR. 

Mark Williams C is just what your Atari ST was 
made for: powerful, professional 
programming. So now that you 
can have Mark Williams C for just 
$179.95, what are you waiting for? 

Ask your Atari dealer about 
Mark Williams C or order today by 
calling 1-800-MWC-1700.* 

"In Illinois call: 312-472-6659 

I Mark 
Williams 
Company 

1430 West Wnghtwood, Chicago, Illinois 6061< 
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Disk Version. 
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Q. What had over 1700 pages, over two 
million bytes of software by the finest ST 
writers (Tom Hudson, David Small, Dan 
Moore, Matt Loveless, Patrick Bass and 
others) and cost only $60.00? 

A. A subscription to the first year of 

START, The ST Quarterly, which included 

Antic, the most successful Atari magazine of all time. 

It's hard to believe START'S been around for a year. We've doubled in circula- 
tion since our first issue-from 25,000 to over 50,000 today, and still growing. 
From June 1986 to June 1987, we've endeavored to publish the best 5T programs, 
tutorials, perspectives and software reviews. Your response assures us that we 
succeeded. 

A computer magazine such as START is a lot like a call-in radio talk show- it 
works better with audience participation. If you had a complaint, a suggestion, 
constructive criticism, or, ahem, praise, then we took your comment and ran with 
it, tried to incorporate your input into our-ymtr- magazine. At START we have 
our own ideas about what constitutes interesting, informative and useful editorial, 
but we can't operate in a vacuum. So, keep telling us what you want. More 
reviews? Programs in BASIC, not C? Perspectives? Hardware tutorials? Tell us 
what we're doing well, and tell us what we need to improve. 

Okay, so what's coming up from START? 

■ A subscription for only $39.95 a year- that's $10 an issue, including a single- 
sided disk packed with so many programs we have to compress them just to 
get them to (it. 

■ A subscription to START with disk and Antic and its magazine-within-a- 
magazine, The ST Resource, for a mere $59.95. 

■ More reviews, overviews, and in-depth examinations of ST hardware and soft- 
ware, including the Mega STs, laser printers, and more! 

■ And, finally, an increase in publishing frequency. When we see the quantity 
of subscriptions go up (and you'll have to help us here) and an increased level 
of advertising that a professional magazine like START needs, then we'll be able 
to leave our quarterly status behind. 

And don't forget our own electronic news service on CompuServe-Antic On- 
line, headed by Charlie Jackson, which provides technical help, downloadable 
software and late-breaking news, such as our famous CES reports. Log onto 
CompuServe, type GO ANTIC and check it out! 

It's going to be an exciting year, and with your support, we'll continue to lead 
the way. 



Jon A. Bell, Editor 
START, The ST Quarterly 
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Life doesn't sit 
neither should your 



still, 
creativity. 



Aegis Animator ST 

We combine three kinds of animation to create a versatile 
animation system for your Atari® ST™. Metamorphic, 
eel and color cycling animation may all be used together 
or independently to build professional quality animations. 
The program is both easy to use and powerful. 
Animations are built visually on the screen using 
interactive tools that make it easy to see what you are 
creating. More advanced users can get extra precision by 
using the optional command language. 

Aegis Art Pak ST™ 

Created by one of the top computer artists this collection 
of images makes it easy for you to enhance your 
paintings or create stunning animations quickly. There 
are hundreds of detailed objects such as animals, 
buildings, trucks, cars, plants, scenery, and much more. 
All of the objects use the same color palette so they can 
work together. This product is a must for any eel 
animation enthusiast. 

CIRCLE 005 ON READER SERVICE CARD Available March 1, 19B7 



See the Aegis Line at your local dealer. 
Can't find what you need? 
Order Direct: 1-800-345-9871 

Please have credit card handy when ordering by phone. 



Name _ 



Address 


City 

□ Check Enclosed 

Oarr1# 


ST Zip 
3 Money Order C VISA/MC 
Fxn 


Sin nature 



. Aegis Animator ST @$79.95 ea. _ 

. Aegis Art Pak ST @29.95 ea, _ 

California Res. add 6.5% Tax _ 

Shipping ($3.00 + $2.00 each 

additional item) _ 

Total . 



Aegis Development 
2210Wilshire Blvd. 
Suite 576 

Santa Monica, CA 90403 
(213) 392-9972 



AICIS 



Atari ST is a registered trademark of Atari Corporatio 
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BLACK AND WHITE AND 
READ IN CANADA 

Can you tell me how to get "reverse 
video" characters like the 800 series 
Atari computers have? 

Jean Gay 

Toronto, Ontario, Canada 

jean, (here are at least two different ways to 
use inverse video characters on your ST. 
First, if you're programming for the TOS en- 
vironment, send the VT-52 ASCII codes 
(ESCAPE! y (that's the ESCAPE charac- 
ter and a lowercase "p") to the console to 

ALERT BOX 



start printing in inverse video. 7b turn off 
inverse, send the codes iESCAPEi "q" (ES- 
CAPE and a lowercase "if). If you're pro- 
gramming in GEM, you'll need to change 
the writing mode to reverse tramparent, us- 
ing the vswr_modc( handle, 4 ) rail 



from the VD1 Library, 



BLACK AND WHITE AND 
BLUE IN ICELAND 

I just bought my 1040ST with a mono- 
chrome monitor, and was wondering if I 
should have purchased the color sys- 
tem. A lot of software only runs on the 



color system. Is there any way to con- 
vert my monochrome programs to 
color? 

Thorarinn Jonsson 
Varma, Iceland 

Bad news, Thorarinn. Unless the program 
was originally designed to work with the 
monochrome system, it would he virtually 
impossible to make any color program run 
in monochrome. Your best bet would be to 
go ahead and buy a color monitor; and 
keep both monitors handy -you'll get the 
best of both worlds. That's what we do here 
at START. Most of our word processing is 
done on the monochrome screen, and we 
boot in color to see the latest Dairel Ander- 
son or Tom Hudson creation. 



TROUBLESHOOTING 
TWISTER 

Last issue, START presented several hard 
and floppy disk utilities by Dave Small 
and Dan Moore. One of these was 
Twister, a program enabling you to add 
another 40K per side of your standard 
3.5 inch ST disks. Atari has even 
decided to adopt the Twister format, 
starting with the new TOS ROMs that 
will be available soon. 

Well, a bug crept into our Twister at 
the last minute. The code on our last 
START disk will place the same serial 
number on each disk when you format 
the disk in Twister format. This causes 
your ST operating system to get con- 
fused, and lose track of which disk has 
been inserted, if you change disks in the 
middle of an editing session. Shortly 
before our last issue went to press, we 
received a phone call from Dave Small 
describing how he had inadvertently 
used a "serial number" parameter of -1 
in the Protobt() call. Dave asked if we 
could simply replace the negative one 
with the value one million, which the 



documentation says should generate a 
new random serial number for each 
new disk. START Technical Editor 
Patrick Bass says, "When I opened the 
hie and replaced the value, I should've 
double-checked to see if the value 
should be binary, decimal, octal, or 
hexadecimal." 

START regrets any problems caused 
by this oversight. To correct it, change 
the value of 1000000L in the Protobtf ) 
function to OxlOOOOOOL (hexadecimal 
one million). 

HEY, THERE'S 
SOMETHING MISSING 

We'd like to apologize to any of our sub- 
scribers who received the last issue of 
START minus their program disk. Our 
printer accidentally mailed out a batch 
of newsstand copies of the magazine, 
which should've been disk versions. 
They assure us this won't happen again. 
However, if you're a subscriber and you 
receive a copy of START without disk, 
contact us and we'll get a replacement 
disk out to you as quickly as possible. 



FACING THE MUSIC 

Why did Atari market a MIDI capable 
machine with such a primitive sound 
chip? The competition uses a top-flight 
sound chip, the same one used in many 
synthesizers. Will Atari reconsider this 
decision and revise the sound chip in a 
later model? Is it feasible to consider 
having an authorized technician modify 
my unit with a better sound chip, such 
as Ensoniq? 

Gerald Stevens 
Birmingham, Alabama 

Gerald, when Atari went about designing 
the ST scries computer, they tried to use the 
most powerful, time-tested "off-the-shelf 
chips wherever they could. In the case of 
the sound chip, it's been in use for nearly 
ton years, and is considered a rock-solid 
performer. However, there's another reason, 
over and above the reliability and speed oj 
the sound chip, that prompted Atari to use 
it. It contains two "free" onboard input/ 
output ports. These two I/O ports are not ► 
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The start of a perfect 
friendship. 




WordPerfect for the ATARI ST" 

If you've been looking for a truly full-featured word 
processor that maximizes the capabilities of your ST, then 
meet WordPerfect. The same power and features that have 
made WordPerfect the best seller for IBM PCs are now 
available in a specially designed version for the ATARI ST. 
A True Professional. 

Regardless of your needs, WordPerfect offers you 
professional features to make your job easier and increase 
your productivity. 

In the office, WordPerfect lets you automate time- 
consuming tasks, streamline difficult work, and maintain 
even the largest documents. At school, you can focus on 
what you're saying while WordPerfect handles the format- 
ting. Even for uncomplicated tasks at home, WordPerfect 
produces professional quality results with simplicity and 
elegance. 

WordPerfect accommodates the most creative imagina- 
tions and most demanding tasks by offering such useful 
features as: Automatic Footnotes/Endnotes 'Table of 
Contents* Indexing • Paragraph/Outline Numbering 



'Macros' Mail-Merge* Math Columns (with Four-Function 
Math)" File Management •Thesaurus' 115,000-word Speller 
•Text Columns. 

A Perfect Match. 

WordPerfect for the ST fully supports the ST interface, 
including pull-down menus and mouse control. Both the 
mouse and the function keys give you complete access to 
all WordPerfect features. 

In addition, the ST version of WordPerfect offets file 
compatibility with WordPerfect 4.1 for the IBM PC. 
Friends For Good. 

So find out what full-featured really means, and get 
acquainted with WordPerfect. You'll be amazed to see how 
friendly a professional word processor can be. For more 
information, call or write WordPerfect Corporation, 288 West 
Center St., Orem, Utah 84057 (801) 225-5000. 



WordPerfect 



CORPORA 



ir rcg, TM's of Atari Corp. 
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Some applications are even facing released 
meaning they'd play the mood music for the 
application through your MIDI synth. Now 
some oj that sound is awesome 



BLITTERABILITIES 

I've read the 520ST is upgradable to one 
megabyte, and I was wondering if the 
1040ST also had RAM upgrades avail- 
able Also, I've heard about something 
called a "blitter" chip. Could you ex- 
plain what it is and what it does? 

Pat O'Leary 
Minneapolis, Minnesota 

Pat, we have an article in the pipeline right 
now that describes upgrading the 520ST to 



logically connected to the sound-making 
capabilities oj the sound chip, so Atari put 
them to use controlling thcjloppy disk in- 
terface and servicing the printer port. By 
doing this, Atari saved having to use an- 
other IC chip for I/O, and devoted the 
motherboard space for it to the MIDI in- 
terface. 

Yes, the chip is awkward to use and 
could be considered primitive, but it's per- 
fectly serviceable for program bongs, beeps, 
boops, whistles, and grunts, and if you actu- 
ally need to whip the chip, you can. ]ez 
San, who wrote StarGlider, gets his AY-3- 
8910 to reproduce digitized speech and mu-. 
sic. The C.I.ST, utility in The Catalog 
renders the AY-3-8910 as programmable as 
almost any other sound chip. Besides, if 
you're really into music reproduction, you 
probably already have a Casio or Yamaha 
synthesizer to play your music for you. 



WHERE'S 
MY 

DISK? 



^^^rAKT is a magazine 
^k ■ with programs on disk. 
4^ * Normally you will find the disk bound into the magazine and selling 
on the newstands for $14.95. 

But some of you ST enthusiasts want to read START first, so we have provided 
a limited number of copies without disk for $4.00 each. 

If this is your situation you can complete your copy of this issue of START by 
ordering the companion disk direct from us, for $10.95 plus $2.00 shipping and 
handling. See the order form inserted into this issue. 



have two megabytes oj RAM, and the 1040 
to hold four megabytes. However, it may be 
to your advantage to have a looh-scc at the 
Mega ST series of computers that Atari 
should be selling shortly after you read this. 
They already come equipped with either 
one, two, or four megfllTytes of RAM. 

The blitter chip ("bit-block transfer 
graphics coprocessor") is an IC whose sole 
purpose in life is to move the contents of 
sections of memory hither and yon very 
quicfely As it stands now, the 68000 "brain" 
inside the ST has to perform the junction of 
moving memory around, which includes 
pictures like the Desktop. The blitter chip 
will perfonn this junction independently of 
the 68000-while the 68000's back is 
turned, as it were. The chip is ready to go, 
and you'll be able to install it inside your 
eurrent 520 or 1040ST. You'll also need a 
new version of TOS-in-ROM, which will in- 
clude blitter chip support subroutines. These 
subroutines (in another fonn) are already 
present inside the ST, but perfonn their 
function using a software approach, instead 
of hardware. The blitter chip will also fae 
standard equipment inside the Mega ST 
computers, 



PROBING FOR ADVENTURE 

] recently bought the "QuestProbe" 
game from Adventure International, and 
when 1 tried to buy the "hint" book, 
found out the company has gone out of 
business. What do I do now? 



William Payne 
Folsom, California 



William, you need to contact Shay Adams 



QuestSusters 

202 Elgin Ct. 
Wayne, PA 19087 
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SOFTWARE DISCOUNTERS 

V^r #» I VI E I\ I \- /A . r rpp shinnino nn nrrlprc 



S.D. of A. 



For Orders Only- 1-800-225-7638 
PA Orders- 1-800-223-7784 
Customer Service 412-361-5291 



Free shipping on orders — \_ 
over $100 in continental USA 
No Surcharge for VISA/MasterCard 
Your card is not charged until we ship 



Play the world's 
great courses. Or 
your own. 
Mean 18 Golf 
List $44.95 
Our Discount Price $25. 




ABACUS BOOKS 



ST3-D Graphics .! 

ST Tricks*. Tip* 
ABACUS SOFTWARE 



AEGIS 

ARTWORK 



..533 
.$33 



mOrif <,nh 



re Coif 



ACAUIM1 

■ICC ESS 



S3J PegRami 

SlripPoker S2 

B ATTERIES IN CLUDED 
D.f.C.A.S. S2 

D.E.C.A.S. Elite H 



DATASOFT 

The City . 
ILLCIKONK A 



It's a whole new 

ball game! 

Hard Ball! 

List $39.95 

Our Discount Price $25. 



HardBall! 



riy Accolade 



Rogue 

■iL.pt-r C v.li- 
TempleAps 



MICROLEAGUE 




500XJ joystick List $19.95 

Our Discount Price $14. 

(for right-handed players only!] 



Geopolitics in the 

nuclear age, by 

Chris Crawford. 

Balance of 

Power 

List $49.95 

Our Discount Pri 




7 S9.88 
S9.B8 
S9.88 



SPEC ritUM HOLOBYTE 



DiskCase (Holds 30) 



The screen burns 

with forbidden 

passion and global 

war! 

S.D.I. 

List $49.95 

Our Discount Price $33. 




P.O. BOX 111327-DEPT. ST-BLAWNOX, PA 15238 



■please Read The Following Ordering Terms A Connilirins f arr-'ullv Hero' 

Perianal A Company checks, allow 3 week* clearance. No C.O.D.'sl Shipping: Continental U 
APO-add 15 on all orders Canada A Puerto Rico -add S10 on all orders. Sorry, no oiherlnler 
including shipping charges! REASONS FOR CALLING C USTOME R SERVICE - 41 2-361-5291 [l)Sf 
oi A. is detective, please call lor a return authorisation number Detective merchandise will be 
charge. Alter 60 days please reter to the manulacturers warranty included with the merchandise . 
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Tom Bajoras graduated from Perm 
State as a chemical engineer in 1983; 
since then he's worked in a variety of 
situations, none of which have had 
much to do with chemical engineer- 
ing. He's played keyboards in rock 
bands, recorded albums, composed 
film scores, and written many hours 
worth of serious music for various 
combinations of piano, orchestral 
ensembles, and electronic instru- 
ments. Tom first became interested 
in programming when he was in col- 
lege, and the combination of Tom's 
musical and engineering experience 
provided him with the opportunity 
to launch a new career as a music 
software developer at Hybrid Arts, 
writing DX-Android, CZ -Android 
and the GenPatch Desk Accessor)'. 



Currently he's working on a music 
scoring program that will interface 
with the MidiTrack ST sequencer 

Contributing Editor Tom Hudson 
should be no stranger to the Atari 
community. He Is the author of 
DEGAS, DEGAS Elite, and CAD-3D, 
versions 1.0 and 2.0. A START Con- 
tributing Editor, Tom has written (our 
previous articles -'Stealing the ST 
Printer Driver" and "Swapping Art 
With Other Computers" in issues 1 
and 2, and "Printer Drivers the Easy 
Way" and "The START Ray-Trace 
Construction Set," both in issue 4. 
Tom lives in Mission, Kansas, and is 
a SYSOP in the ATARU6 forum on 
CompuServe. When he's not pro- 
gramming, he relaxes by listening to 




BACKUP PROTECTED 
SOFTWARE FAST. 

From the team who brought you 
COPY II PLUS (Apple), COPY II PC 
(IBM) and COPY II MAC (Macintosh) 
comes a revolutionary new copy 
program for the Atari 520 and 1040 ST 
computers. 

COPY II ST copies many protected 
programs automatically. 

• Supports single and double sided 
drives. 

• Includes a sector-based copier for 
fast, reliable copies of unprotected 
disks, 

• Includes a bit copy mode for 
protected disks. 



Requires an Atari 520 or 1040 ST 
computer with one or two drives. 

Call 503/244-5782, M-F, 8-5 
(West Coast lime) with your HI S$ 
in hand. Or send a check 
for $39.95 U.S. plus $3 s/h, $8 
overseas. 

$39.95 



Central Point Software, Inc. 
9700 S.W. Capitol Hwy. #100 
Portland, OR 97219 

CentrdFbirU 
Software 



Backup utilities also available for the IBM, Apple II, Macintosh and Commodore 64. 

This product is provided for the purpose of enabling ',\n: tomato ;.',':.-■';. i;i( copies only. 
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Tangerine Dream and hring assault 
rifles. He also plays a killer game of 
racquetball. 



Charles F. Johnson is a profes- 
sional musician who has toured the 
world playing guitar with George 
Duke, Stanley Clarke, and Aljarreau. 
He bought an Atari 400 back in 1980 
after seeing a demo of the Star 
Raiders game, and ended up learning 
to program computers. Currently, 
he's trying to land a record deal with 
his own band in L.A., called Catzeye. 
When he's not working on musical 
projects he enjoys programming the 
ST in 68000 assembly language- 
Jim Kent studied mathematics and 
art on and off at UC Santa Cruz for 
seven years before he decided to get 
rich in the computer graphics busi- 
ness. Since 1983 he's worked on 
Micro-Illustrator for the Tandy Color 
Computer, parts of several paint sys- 
tems including Targa TIPS, and Aegis 
Images-and Aegis's Animator pro- 
grams for the Amiga and ST. Jim's 
also the moderator of the Atari ST 
conference on BIX, where he can be 
reached online. 

Ignac A. Kolenko Jr. is a 

second-year student at the University 
of Waterloo in Waterloo, Ontario, 
majoring in Computer Engineering. 
He has been programming personal 
computers for six years- first on a 
Timex/Sinclair, then on an Apple II, 
and for the last year on an ST When 
he's not hitting the books. Ignac en- 
joys camping and bike riding-and, 
of course, astronomy 

Consulting Editor Matt Loveless 

has been writing and programming 
professionally since he was 14 years 
old. He became involved with Atari ► 
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PUBLISHING PARTNER™ 



CREATES LIKE A PUBLISHING COMPANY WITHOUT THE OVERHEAD 




SOFT LOGIK NEWS AVAILABLE FOR ONLY S149. 95 

PUBLISHING PARTNER ™ 
HELPS YOU CREATE! 

You'll benefit by using your Atari ST to create professional quality 
journals, newsletters, ads, business cards, certificates, letterheads, 
logos, art designs, bar graphs, flow charts, even bumper stickers and 
all the forms you or anyone would ever need. Create just like a 
professional publishing company without the overhead! Publishing 
Partner is actually three progams in one-- VVord Processor . 
Pa ge Layout , and Forms Creator . Expand your potential in becoming 
a better writer, artist and designer with your Publishing Partner. 

WORD PROCESSING PAGE LAYOUT FORMS CREATOR 

You can create a variety of forms quickly 

and easily with your Publishing Partner, 

For example, you can create your own: 

Letterhead 

Invoices 

Purchase Orders 

Labels 

Bumper Stickers 

Business Cards 

Certificates 

General Ledger 

Shipping and Receiving 

Routing Slips 

"While you were out" Phone messages 

Templates 

Price Estimate forms 

Requistion forms 

Shipping Logs and much more! 

Publishing Partner supports most dot 

matrix printers, including the Epson tm 

Star tm and Okidata tm Printers. Also 

supported are any Postscript output 

devices such as the Apple LaserWriter ' m 

New print drivers are constantly being 

released, so please call to make sure 

your printer is supported. 

FOR MORE INFORMATION OR TO PLACE 

AN ORDER, CALL {314)894-8608. 

DEALER INQUIRES INVITED. 



Wha t yo u gee is what ypu get ! 

Combine text and graphics easily and 
quickly from existing or newly created 
documents. Position entire paragraphs 
or individual words exactly where you 
want them. Create one, or multiple color 
separations ready for printing. 
Production time will never be the same- 
it will be much shorter!! 
Just take a look at some of its features! 

* GEM based 

* Justifies right or left as you type 

" Edit Multiple Columns on One Screen 

* Search and Replace 

* User Definable Page Size 

* Bold, imdgr!inS, su P er and subscrip , 

* Italicize, shadow, outline 



—EH 



Mirror Image 
erjsml ioniM 



Invert Image 
|UA6ij |ujsde 



Auto Headers/Footers, Page Numbers 

Easily Move Text 

Reads & Merges other files together 

Sets Tabs 

Macros 

Vertical & Horizontal Printing 



Whatever you require-cutting artwork 
from other programs, custom logos, 
unique borders, unusual mastheads, 
digitized photos- Publishing Partner is 
your solution. After all, it was specially 
designed for you-the home and/or office 
Atari ST user-by the pro's who realize 
that there's more to your computer than 
just typing letters. 

* Vert, and Horz. rules- Exact Alignment 

* Auto Text flow for columns/pages 
" Layout Multiple Columns of text 

' Change columns on finished page 
' Display entire page, 50%, or 25% 

* Easily Re-position Text and Graphics 

* Alternating Headers/Footers 

* Mix Type, Fonts, and Sizes anywhere 

* Adjust Sizes from 2pts to 1 44 pts (2") 

* Adjust line spacing (leading) by points 

* Import other program's graphics 

* Rotaie Graphic Images 

* Multiple Patterns, Shades and Colors 

* Enlarge & Reduce Graphics/ Exact fit 
' Cut, Paste & Crop Graphics 

* Tool box function/Unlimited patterns 

* Boxes, Circles, Arcs, Polygons, etc. 
' Insert lines directly on the page 

* Adjust Character Spacing 

* Use Hairlines to separate columns 




Soh Loqik CoRp." 
J 



4129 OLD BAUMGARTNER * ST. LOUIS, MO. 63129 
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computers when he developed a util- 
ity package. Page Six, for the original 
400/800 8-bit machines. He was a 
game designer at Synapse Software 
for four years, and in 1986 became 
START'S Assistant Editor. Matt has 
since gone freelance, acting as advi- 
sor for START magazine and tackling 
a number of lucrative programming 
and writing projects. His most recent 
accomplishments include the Mega 
ST User's Manual for Atari Corp. and 
work on the CyberMate experimental 
animation language, used with Tom 
Hudson's CAD-3D 2.0. 

Daniel Matejka has been pro 
gramming professionally, on and off, 
for over seven years. Four years ago 
he stumbled upon the crowd that 



makes and markets DB Master, a 
best-selling database on the Apple II 
which has been incarnated on 
several other machines as well. Dan 
was partially responsible for the IBM 
PC and Atari ST versions of that pro- 
gram. He lives in Colorado Springs, 
and is an independent software de- 
veloper. He wrote Disk Doctor and 
Base Two, for Antic Software, and 
also Red Alert, a collaboration with 
Stanley Crane, one of the original DB 
Master programmers. 

Jim Pierson-Perry is a research 
chemist for DuPont who leads a 
double life as a programmer and mu- 
sician. He has worked with com- 
puters for 16 years and Ataris since 
1982. His interest in music dates to 
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3 ME 

ma DoubleThink Plus 



For your word processing, spreadsheets, desktop publishing, 
programming, or other memory-intensive applications, there's 

nothing like DoubleThink Plus, the 
only 520/1040 expansion which gives 
you 3 megabytes of all-purpose RAM. 

A COMPATIBLE with your software 

A PLUG-IN installation you can do 

yourself quickly and easily 
A ONE YEAR WARRANTY 
A ACCESSORIES -RAM disk and 
other software included 

Write or call today for a free brochure. We also have Double- 
Think, a one meg expansion for the 520. * Sorry, but current foreign 
trade problems make it impossible to know the future price of RAM. 




ThoughtSpace 
Development 



2450 Warring St., No. 21 
Berkeley, CA 94704 
(415) 845-1415 



early childhood when he was beaten 
over the head with a toy piano by his 
brother. Author of several programs 
published in Antic, Jim now lives in 
Elkton, Maryland, with his wife, four 
daughters, assorted cats and a dog. 
He is currently setting up a home 
MIDl-based music studio, writing 
software to support it, and occasion- 
ally manages to do enough clinical 
chemistry work to justify a paycheck. 

David Plotkin, BASIC expert, has 
written countless programs, in both 
BASIC and Action!, for our sister 
magazine Antic. In past issues of 
Antic, he has authored a series of be- 
ginner's tutorials. An engineer at 
Chevron USA, David designs and 
builds oil processing plants and 
offshore platforms. David says he 
just bought another 520 ST for his 
wife, so they don't have to fight over 
the computer any more. 

Jeff Wilson is a senior in Physics 
and Computer Science at Brigham 
Young University in Provo, Utah. He 
has been programming micro- 
computers for the past eight years, 
and Atari computers for the last six 
years. He is currently president of 
the Utah County Atari Nuts, his local 
Atari user's group. For the past three 
years, he has been employed by 
WordPerfect Corporation as a soft- 
ware engineer. While there, he par- 
ticipated in development of Word- 
Perfect for the Apple Ile/IIc 
computer line. He is currently 
managing development oi Word- 
Perfect for the Atari ST, which should 
be available shorriy after you read 
this. He programs exclusively in as- 
sembly language, and enjoys it! ■ 
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Lyco Computer 

Marketing & Consultants 



SAVE ON THESE IN STOCK PRINTERS! 



Panasonic 

Industrial Company 




1080 i 
$195.00 

• 120 cps Draft Mode 

* 24 cps NLQ 

* Word Process 

• Friction Feed 



STAR MICRONICS 

NX10 $195 

NL-10 S209 

NP10 S169 

SD-10. . S259 

NB-15 SB89 

ND-15 ... S425 

NX-15 S339 

NR-15 5529 

NB24-5 S72B 

CITIZEN 

120D S179 

MSP-10 SSBS 

MSP-15 S385 

MSP-20 5325 

MSP25 S485 

Premie/ 35 S469 

SEIKOSHA 

SP-1200AS S196 

SP-12O0AI SI 95 

BP-5420.... $1075 

BP-5420 ribtwn S12.50 

MP-53O0AI $549 

Color Kit S119 

NP 1300AI S369 



PANASONIC 

10801 S195 

1091i.... S269 

10921 S335 

1592 S359 

1595... S499 

3131 S259 

3151 S379 

EPSON 

LXB6 S205 

EX-BOO S3S5 

EX-1000 S579 

LQ-8O0 S449 

LQ-10Q0 S659 

FX-286e 5519 

FX-B66 S3B9 

OKIDATA 

OkimalaSO S129 

Plug n prim SCALL 

12DNLQ S209 

182 S245 

192* S365 

193+ S559 

JUKI 

6100 ..,,$365 

5510w/color $435 

6300. S739 




NX-10 $175.00 

with purchase of printer stand 

LtmiteO offer 



A 

ATARI 



1040 ST MONO SYSTEM! 

with a 
SEIKOSHA 1 200 Al PRINTER 



LYCO PROVIDES 90 DAY WARRANTY 
AT NO EXTRA CHARGE 



$899.95 




MAXELL 
SSDD . . 

DSDD 

BONUS 
DSDD '.'.'.'.".' 
SKC 

SSDD 

DSDD 

DSHD 

VERBATIM 
SSDD 



S9.99 S1G.99 



. S9.99 S16.99 



Call for generic diskette pricing! 



A 



520 ST COLOR SYSTEM 

$725.00 



ui°9o"d°,y des * 520 Keyboard 

seivice warranty * SF-354 Disk Drive 

at no additional ^ SC- 1 224 Color Monitor 



/ 




ATARI 




*\ 




MODEMS 


HARDWARE 


COMPUTERS 










520StMono...$515.95 






12O0hc $119.95 


DRIVES 


520StColor... $725.95 






Hayes 300.... $125.00 










Hayes 1200. .. $369.00 


SF314 $219.95 


1040SI color... $889.95 




V 








/ 



AcWisioK 

Baskelball 328.75 

Music Studio $36.75 

Hacker II $28.75 

Paintworks $38.75 

JH££9M§§ 

Leaderboard $24.75 

Tournament DSK1 , . . $15. 75 
10th Frame $24.75 



WE STOCK OVER 5000 SOFTWARE TITLES! 
OSS BsbopftJiK. 



FIREBIRD 

Starglider $26.75 



mil 



E pYX 

Supercycle $24.75 

Winter Games $24.75 

World Games $24.75 

Wrestling $24.75 

Karate Champ $24.75 

MicroProse 

Silenl Service $24.95 

F-1 5 Sl'ike Eaqle $24.75 



■JjEL— 

Phantasie II $24.75 

Road War 2000 $24.75 

Colonial Conquest .... $24.75 

iriFocorr\ 

Leather 

Goddesses. $24.75 

Moonmist :.. $24.75 

Hollywood 

Hi-Jynx $24.75 



TO ORDER CALL TOLL FREE 

1-800-233^760 

1NPA717-494-1O30 

CUSTOMER SERVICE 

71 7-494-1 670 



or send to 

Lyco Computer 

P.O. Box 5088 

Jersey Shore, PA 17740 



1-800-233-8760 



In-stock items shipped within 24 hrs. ot order. NO deposit on C.O.D. orders. 
Free shipping nn prOpsjd BBBf] OfdM within (tie Conlinental U.S. Volume 
discounts available. PA residents add sales tax. APO, FPO and international 
orders add 55.00 p us 94t for priority mail. Advertised prices show 4% dis- 
count tor cash, add 4% for MasterCard and VISA. Personal checks require 
4 weeks clearance before shipping. We cannot guarantee compatibility. We 
inly ship factory fresh merchandise. Ask aboul USP Blue and Red Label ship- 
ping. All merchandise carried under manufacture's' warranty. Return restric- 
tion applicable. RetLrn authorization required. We check for stolen credit cards. 
We accepl purchase orders from educational institutions. All items subject 
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Powerful ST animation for everyone 

by JIM KENT 

Have you ever wanted to be a cartoon animator? It doesn't 
take yean of time or millions of dollars to make a face smile 
or a fish swim; all it takes is an old-fashioned flip-book- 
or Flicker, a new program by the author of Aegis Anima- 
tor ST. You'll find Flicker and a few sample animation files 
on your START disk! 

HFile FLICKER.ARC 
on your START disk 

START. The ST Quarterly 16 Summer, l<JH7 
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This Flicker animation sequence is on your START disk as GRAMMA. SEQ. 



a movie, c 

kw You m; 

9L» schoo 
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Kou'veseen [lip-books: little pads of stiH paper, each page 
with a drawing on it. You bend the book into an arc, one 
thumb over the page ends; then, sliding your thumb 
down, you let the pages flip past very quickly. Like frames in 
a movie, the flipping pictures give the appearance of motion. 
You may have made your own flip-books as a bored 
schoolkid, drawing a dozen or so little faces or stick 

figures in the comer of your thick, boring history 
book, then sending them through their gyrations- 
a wink, a growing smile, a stick figure kicking up his/her/its 
legs. It's probably the easiest (and certainly the cheapest) form 
of animation to produce. With a flip-book you have to draw 
each frame entirely, but the impressions your pencil left from 
your previous frame can help to guide you. 

Flip-books won't let you create a full-length Fantasia, but 
they are a lot ol fun, and in my case, the germ ol a new pro- 
gram. Inspired by the multiple work screens of DEGAS Elite, 1 
decided to write my own flip-book animation program for 
the ST, 1 call it Flicker 

SEm The ST Quarterly 



Flicker is basically a nifty little ST paint program. It has 
some drawing features I'm really proud of-the airbrush, a 
non-blinking cursor (easy on the eyes) and a really nice full- 
screen zoom. It also has lots of work screens, and. of course, 
the ability to cycle through them at various speeds, Flicker 
can read and save single-screen files from NEOchrome or 
DEGAS, and also save entire animation sequences. The pro- 
gram does have a limitation you should be aware of- it 
doesn't tun on a monochrome ST You'll see why when you 
run the program. 

USING FLICKER 

In the archive file FLICKER.ARC you'll find about 30 files. 
Most of them are source files. But to get started with the pro- 
gram, just copy the archive file to a disk with lots of free 
space, and un-ARC FUCKER.PRG. Change to low-resolution, 
then double-click on the FLICKER icon and in a few mo- 
ments you should be greeted with a black screen with a white 
hollow-cross cursor on it. You can start drawing immediately ► 
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Flicker. 




FIGURE 2 



by holding down the left mouse button as you move the 
mouse. 

Flicker uses "pop-down" menus. These are much like nor- 
mal 5T drop-down menus except they are invisible until you 
hit the right mouse button, which toggles the menu bar on 
and off. 1 had a lot of technical problems using drop-downs, 
but worst ol all, they make it hard for you to use the top part 
of your screenl 

Try pressing the right mouse button down. The words 
"File Edit Draw Misc Frames Brush Color" should appear on 
the top of the screen. Move the mouse into one of the words 
and a menu should pop down. Try running the mouse from 
left to right across the top of the screen, and you'll see all of 
the options Flicker gives you. A picture of the Brush menu is 
in Figure I. Most of the menu options have keyboard equiva- 
lents. I'll go through the menus an option at a time a little 
later, but first let's get started with a simple animation-a face 
winking. My version of a winking face is on disk as 
WINK.5EQ. 

Pick a color you'd like from the Color menu, perhaps light 
blue. Figure 2 has the first face 1 drew, one with both eyes 
open. As you draw you might want to get close up to some 
areas. Just hit the z for zoom, and a framing box will appear. 
Position it over the area you'd like to blow up, then click. Fig- 
ure 3 shows a zoom of my face's left eye. When you want to 
see the full screen just hit z again. Made a mistake? Hit the 
Undo key and the last line you drew will disappear. When 
you're done drawing, select Append from the Frames menu. 
Flicker will create a new frame that's an exact copy of the 
previous frame, and now you'll be drawing on the new frame. 
You'll see a message saying you're on frame 2 of 2 and how 
much memory you have available. 

Now comes the fun part. From the Edit menu select Blue 
Pic. Figure 4 shows what happens. All colors on the screen 
except black (color 0) changed to dark blue (color 1). Think 
of this color as non-reproducing blue — you can see it, but it 
will vanish in the final version. You can use this blue sil- 
houette to guide you as you draw the next frame. (Remember 
the pencil impressions left in your history book?) Trace over 
the blue, making slight changes to create the second frame of 
your animation. Then flick back and forth between frames 



with the left and right arrow keys. When you're happy with 
the new frame, select Unblue Pic from the Edit menu and the 
blue will vanish into the background color Figures 5 and 6 
show my second frame before and after "unblueing." You re- 
peat this procedure -Append, Blue Pic, draw, Unblue Pic- 
until you have all the frames you'd like. For the final frame 
you might want to visit the first frame to make sure the pic- 
ture doesn't jump too much when the animation loops 
around. You can use the up and down arrows to go to the first 
and last frames. 

Flicker will let you make up to 128 frames if you have the 
memory-a Mega ST4, with four megabytes of RAM, would let 
you do it. On an unmodified 520, depending how many desk 
accessories you have, you'll probably get an "out of memory" 



Inspired 

by the multiple 

work screens of DEGAS Elite, 

I decided to write 

my own flip-book animation 

program for the ST. 

1 call it Flicker. 



message if you make more than 8 Irames; on a 1040 you 
should get over a dozen. Append will make a new frame im- 
mediately after whatever frame you're on, so you'll usually 
want to make sure you're on the last frame before appending. 
If you want to watch your animation play through, without 
getting manic on the arrow keys, go back to the Frames menu 
and select Play Forwards. This will go from one picture to the 
next in ten l/60ths of a second (10 jiffies). You can also Play 
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Slowly at 20 jiffies per frame, or Play Fast at 4 jiffies per frame. 

After you finish your computer graphics epic (The Last 
Starfighter II?), you'll probably want to save the animation 
you've made. To do this, select Save Seq from the Files menu. 
You'll get the standard GEM File Selector box. Type in the file- 
name for your animation (don't forget the .5EQ extender) and 
press the Return key or click on OK. Before saving the file, 
Flicker checks to see if you have enough space on your disk- 
Flicker doesn't save the whole picture for each frame-just 
enough of it to hold the part that isn't the same color as the 
background. Still, .SEQ files still can get pretty large; I have 
one that's 150K! (If you spend much time doing computer 
animation, you'll probably find as 1 do that a good, cheap, fast 
hard disk is more important to an animation programmer 
than a blitter chip-but I'm not going to knock any neat hard- 
ware Atari decides to offer.) 

Though Flicker is most fun for quick flip-book type doo- • 
dies, it is actually a fairly powerful paint system as well. 
While DEGAS Elite is definitely your choice if you have to do 
a lot of text in a variety of fonts, and NEOchrome has more 
different shapes, you might find as I do that Flicker is the 
best for drawing things by hand. You can see the time I spent 
on the frames shown on pages 16-17. (This animation's on 
your START disk as GRAMMA.SEQ). The combination of the 
full screen zoom, being able to pick up a color under the cur- 
sor, and not having the cursor blink at you all the time really 
makes Flicker great for doing detail work. The airbrush really 
sprays! Not just a little drizzle, but with enough guts to make 
you feel like decorating a couple of subway cars with graffiti. 
Try spray with one of the bigger brushes for real pixel 
demolition. 

I dislike having to change from medium-resolution (where 
I do most of my text editing and programming) to low- 
resolution to run graphics applications in 16 colors. Unfor- 
tunately GEM is pretty silly about adapting to new resolutions 
unless you go through the "Set Options" dialog on the desk- 
top. Ninety percent of Flicker's functions will work if you start 
it from medium resolution -enough to replay animations and 
use most drawing functions. However the flood fills and poly- 
gon fills will only work for the first three colors. 



FLICKER A FUNCTION AT A TIME 

flicker has many more features than you saw in that brief 
walk-through, including cut-and-paste, some pre-defined 
shapes, and area fill. 

There are 44 functions you can choose from the pop- 
down menus, and you can select from among 16 brushes and 
16 colors. One way to explore them is by just playing with 
the program-you can learn a lot simply through experiment- 
ing on your own. But here's a complete list of Flicker's func- 
tions, divided into separate sections for each of the pop- 
downs. Where keyboard equivalents exist, they are noted in 
parentheses immediately after the function name. 

File 

• About Flicker- displays copyright notice. 

• Load Pic-loads a DEGA5 CPU) or NEOchrome (.NEO) 
file into current frame (DEGAS usually, NEO if you've 
selected NEO under Misc). 

• Save Pic -saves a NEO or DEGAS file from current frame. 

• Load Cel-loads a DEGAS .CEL file into the clip buffer. 
The eel will appear momentarily on the screen after it's 
loaded, but to use it in your animation you must select 
Paste under the Edit menu. 

• Save Cel- saves the clip buffer to a .CEL file. Clip or Cut 
out a piece of a picture from the Edit menu first. 

• Load Seq -loads an entire Flicker sequence Careful with 
this one, because there's no undo! 

• Save Seq-saves all frames to a .SEQ file Checks disk free 
space first (this can take a while on a hard disk). 

■ Load Col-loads color map from a COL file (a simple 16 
word file). 

• Save Col -saves color map. 

Edit 

• Undo-(or Undo key) forgets last thing you did to this 
frame. ► 
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Blue Pic-(or ( key) turns everything that's not the back- 
ground color (color 0) to "non-rep ro-b hie" color (color 1). 
Unblue Pic— ( ) key) removes non-repro-blue color. 
Clear Pic - (or Backspace key) turns this frame to back- 
ground color 

Clear Seq-deletes all frames. Watch it-this one also 
doesn't undo! 

Cut-(Fl) cuts out a portion of the screen into clip buffer 
for later pasting or to save as a .CEL file. Your cursor will 
become a full-screen cross until you pick the one corner of 
the box to save. Hold the left button down and drag it to 
the opposite corner and release. Hit the right mouse but- 
ton if you decide not to cut out anything. 
Clip-(F2) clips all non-zero portions of the picture into 
the clip buffet That is, the ST will find the smallest box 
that has anything drawn in it. 

Paste-(F3) puts a copy of the clip buffer onto the screen. 
Hit the right mouse button to leave it exactly in the posi- 
tion you clipped it from, or drag it to a new place with the 
left mouse button. 

Fit Colors -(F4) If the .CEL has a different color set than 
the picture you're in, this will adjust the colors of the eel to 
the closest colors it can find in the picture's color set. 



where you want a corner of the box to be, then drag to the 
box's opposite comer and release. A box can be either hol- 
low or filled. 



Miscellaneous 

• Status- (space bar) displays which frame you're on, how 
many frames you've created, how much memory is left, 
and how much you started with. 

• Zero Clear- determines whether the background color of 
a eel is treated as transparent when a section is cut and 
pasted (default is transparent). 

• Filled -determines whether polygons, circles and boxes 
are hollow or filled (default is filled). 

• NEOchrome— determines whether pictures files are 
DEGAS (the default) or NEOchrome format. 

• Zoom-(z) toggles zoom on and off. When you turn it on, 
a white frame will appear around the cursor Move the 
frame to the area you want to magnify and press the left 
button. Flicker's zoom can only move horizontally in 16- 
pixel jumps. 



Draw 

• Draw-plots a dot or brushes down as long as you hold 
down the left mouse button. 

• Drizzle -a slow, relatively small airbrush. 

• Spray-a big fast airbrush. Works with brushes, too-very 
quick! 

• Flood-fills an area with a color 

• Line-draws one straight line. Push the left button down at 
the point you want to begin the line, hold it down as you 
move to the other end, then release it. 

• Lines-draws connected straight lines. Click the left button 
at the endpoint of each line. Press the right button to end. 

• Polygon-draws a free-form polygon. Click left button over 
each comer, right button to end. This will be hollow or 
filled depending on the Filled selection under Misc. 

" Rays- draws rays radiating from a single point. Click the 
left button over the center, then move the mouse to where 
you want the first ray to appear. Click the left button again 
for each individual ray, or hold the left button down and 
whoosh around the center to create a series of rays 
quickly. Click the right button to end. 

• Circle -Push the left button down over your centerpoint 
and drag out a circle to the desired radius. A circle can be 
either hollow or filled. If it's hollow it will be drawn with 
the current brush. 

• Box- creates a rectangle. Hold the left mouse button down 



Frames 

Go Forward - (right arrow) moves to next frame in sequence. 

Go Backward -(left arrow) moves to previous frame. 

Go to Last— (down arrow) moves to final frame in se- 
quence Usually you'll do this before appending a new 

frame. 

Go to First- (up arrow) moves to the start of the sequence. 

Append -(Clr/Home key) creates a new frame after this 

frame. It starts out as an exact copy of this one 

Insert-(Insert) creates a new frame before this one. 

Delete-(Delete) removes this frame. Screen jumps to next 

one. 

Play Forward-(FIO) flips through screens at normal 

speed-6 frames per second. 

Play Backward— (F9) flips through screens backward at 6 

frames/sec. 

Play Slowly- (F8) flips forward at 3 frames/sec. 

Play Fast-(F7) flips forward at 15 frames/sec. 
Brush lets you select one of 16 brushes. The hollow cross 
brush on the upper left actually draws a single point 
Color lets you select one of 16 colors. You can select the color 
under the cursor by hitting the c key. 

THE NITTY GRITTY 

If I gave an exhaustive explanation of how this program works 
it would probably fill up this entire issue of START, and it 
would take me longer to describe Flicker than it did to write it 
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in the first place! However, the source code is on your START 
disk in the file FLICKER.ARC for you to look at. To examine 
the source files, un-ARC them, following the instructions on 
the Disk Instructions page in this issue of START. 

The program is roughly one-third assembler and two- 
thirds C. The text editor, assembler, compiler, linker, and 
make utility are all from Manx Software's Aztec C package. 
Aztec C is the developers choice on the Amiga. By doing 
some work for Manx I was able to get an alpha version to 
work with on the ST. Since it's not released yet, all 1 can say is 
I hope the rest of you get to link this fast soon! 



The airbrush 

really sprays! Not just 

a little drizzle, but with 

enough guts to make you 

feel like decorating a 

couple of subway cars 

with graffiti. 



Most of the drawing and page-flipping routines are written 
in assembler, and most of that code is pretty boring. This is 
because to get any speed out of the ST you must have a sepa- 
rate drawing routine for each color With the "interleave -bit- 
plane" organization of the ST, routines that draw only one 
color run two to three times as fast as routines handling any 
color. In the assembler source you'll find 16 dot-plotting rou- 
tines and 16 ways to draw a brush. (Someday, I hope we'll 
have access to a byte-a-pixel graphics engine.) 

Also of potential interest to graphics speed-freaks is the 
zoom routine, which can blow up an area by a factor of 4 
onto a full screen in l/26th of a second. It uses some table 
lookups and a lot of in-line code. There's another big table- 
lookup in the airbrush code, which does a conversion from 
polar to Cartesian coordinates with one lookup, two swaps 
and two multiplies. 

Another reason the airbrush, cursor and draw routines can 
go fairly quickly is that 1 keep 16 copies of the current brush, 
each shifted over a pixel, so the poor 68000 doesn't have to 
shift during draw time. With a blitter chip, I wouldn't need to 
do this. 

There's a circle -drawing routine in CIRCLE. ASM, and its 
filled version in D1SK.ASM. Take a look at them. You might be 



surprised to find that incremental circle algorithms can be 
just as simple, and potentially faster, than incremental lines. 

Finally there's the beam-skipping: In the file CLOCK.ASM 
you'll find not only a way to access the 200Hz system timer, 
but also ways to see where on the screen the video beam is. 
That way you can avoid drawing on the parts of the screen 
that the beam is updating. It's this code that prevents the cur- 
sor from flickering. 

The C code, which handles most of the decision making 
and user interface, is a bit more convoluted. The main routine 
is in the file MAIN.C. This consists of little more than system 
initialization and a forever loop-for (;;)-checking to see if 
there's a key to interpret or if a mouse button is pressed. 

If the right mouse button is pressed, mainQ calls the pop- 
down interpreter in PULLC, The data for the pop-downs is in 
CELPULL.C. If the left mouse button is pressed, control 
jumps through a function pointer (pentool) to some routine 
depending on what's selected from the Draw menu. Most of 
these routines are in PENTOOLS.C. 

The pen tools themselves, as well as most of the other 
functions, are complicated greatly by doing hide_mouse( ) 
calls before any drawing begins, and show_mouse() calls 
when drawing is done Further, making sure the screen gets 
updated in "zoom" mode leads to lots of little function calls. I 
haven't found a really elegant way to design this that would 
still be fast; I just beat on it until 1 got it right. 

If you're interested in a fairly clean-looking piece of code 
that may be useful to you, take a peek at PULLC. There are 
still some zoom-buffer complications, but with any luck you'll 
figure out how to yank them out and have nice, responsive, 
unobtrusive pop-downs for your own application. (Be fore- 
warned: the one disadvantage to pop-downs is that they lock 
out desk accessories.) Pull() takes a simple tree data- 
structure. Rather than having a million flags to decide how to 
draw something (like GEM does), pullQ has a slot for a 
drawing function. If you need something other than text, a 
brush, or a box, you can just write your own function and 
stick it here. The code calls the function in the structure with 
the structure itself. This very powerful programming tech- 
nique is how object-oriented programming languages such as 
Smalltalk and C++ implement "methods". 

Don't be afraid to dig into the code and experiment with it. 
If you have any questions, I can be reached on BIX, where I'm 
the Atari ST moderator. In the meantime, happy flicking, and 
maybe happy tweening too! ■ 

IF YOU'D LIKE TO SEE MORE ARTICLES LIKE THIS ONE, 
CIRCLE 179 ON READER SERVICE CARD 
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Multiple window editing 



Programming 
Made Easy 



If you're into programming, or if you 
want to be, you won't find a better 
system for your Atari ST than ALICE: 
The Personal Pascal. Already popular 
on the IBM-PC, ALICE now brings 
easy, interactive programming to the 
Atari ST. 

ALICE is, without question, the best 
way around to learn about computers 
and programming. Beginners can even 
order our ALICE based textbook for 
only $19.95 with ALICE. 
Even if you're an expert, ALICE 
makes it easier to write, test and 
especially debug programs. ALICE'S 
extensive Pascal improvements in- 
clude a GEM interface even beginners 
can use and most of the extensions of 
Turbo Pascal. The surrounding 
examples just give a glimpse at how 
easy it is to put programs together 
using ALICE. 




"If I needed to learn Pascal alt over again, or 
were going lo teach a course in the language. I 
can'l imagine using any program other than 
ALICE, " 

— Adam Green, Infoworld 



Visit your dealer or send us 178 H (USD) plus 
S5 For shipping and handling. Major credit 
card orders may phone collect. Dealer inquir- 
ies invited. IBM-PC version $95. 



Breakpoints, Single Step 



"ALICE may be the most advanced pro- 
gramming environment currently available for 



— Michael Covington, PC World 

Looking Glass Software 

p00|<iui (1(322 JWyMLK 



but we'd rather show 
you . . . 






Instant-run Pascal intei 






Every error fully explained 









■'■"HIM nil liilil \m^^\ | turn r 




'&1' 








jfc, 




CSJ c^H 













"If you enjoy programming languages, this 
comes pretty darn close to being as much fun as 
a video game." 

— Gene Wilburn, Computing Canada 



Looking Glass Software Limited 

124 King St. N. Waterloo, Ontario 

N2J 2X8 

519/884-7473 
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A Super Toolkit 
For DEGAS Elite 

Exploring the built-in desk accessory hooks 



by PATRICK BASS 

START TECHNICAL EDITOR 

Up to now, communication with DEGAS Elite has been 
limited to keystrokes, mouseclicks, and occasional moans 
of frustration. Continuing in a series of articles dealing with 
upgrading DEGAS Elite, Patrick Bass shows you how to 
construct your own desk accessories which capitalize on the 
built-in GEM message pipe to add your own features to this 
powerful drawing program. 



m^^ EGAS Elite is a program that could sell the ST series computer all by itself. It's 
MM one of the most powerful an programs available for any 16-bit computer But, in- 
■^ evitably, after many hours of using it you'll find yourself saying, "Gee, ifl could 
just. . ?", or "Golly, why can't it. . .?", or similar groans. 

How would you like to be able to command DEGAS Elite to perform your own func- 
tions? Have you come up with something you need DEGAS Elite to do that it can't do now? 
In "Plumbing In GEM" in this issue of START, Tom Hudson describes a communica- 
tions channel he has built into DEGAS Elite, which allows your GEM Desk Accessories 
access into the very heart of DEGAS. ► 

ill fife TOOLKIT.ARC 
Hi on your STA RT disk 
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The Page Flipper lets you perform simple eight-frame animation from within DEGAS Ellt> 



With this "pipeline," you may now create programs that ac- 
cess Elite's picture buffers, allowing you to apply your own fa- 
vorite picture manipulation routines. 

But just exactly how do you go about telling DEGAS Elite 
what to do? Nothing is better than an example, unless it's two 
examples, so that's what I've provided Tor you in this issue. 
First, we'll create the Page Flipper, which will allow easy page- 
flip animation from the DEGAS Elite main menu screen. Sec- 
ond, we'll build the Screen Operator, which will allow you to 
play "what if" with the many different writing modes the ST 
allows, or let you "add" or "subtract" one picture from an- 
other. Let's discuss them both in general first, before we get 
into the nitty-gritty of how and why they work. (Editor's note: 
For another program that allows you to do ST Animation, see 
"Flicker" by Jim Kent, author of the Aegis Animator, in this issue of 
START.) 

FLIPPING OUT 

There are basically two different ways to perform animation 
on a computer screen. One way is to erase the screen, then 
draw the first image onscreen, erase it, draw the second im- 
age, and so on ad infinitum. Done quickly enough, this may 
look perfectly acceptable, but if you don't increase the writing 
speed to the screen, as the image size grows larger it takes an 
increasingly longer and longer time to draw each image, until 
at some point the drawing process becomes visible to the ob- 
server. From that point on, the "animation" will appear to 
strobe, and lose its credibility as an animation system. 

Another way is to draw every picture beforehand, and 
then flip through them at a fast clip. DEGAS Elite allows us to 
hold up to eight complete pictures, or workscreens, on a 
megabyte ST system, which is just enough for us to get 
smooth, cyclic motion. For example, you could draw a wheel, 
eight times, each time with the wheel rotated another 45 
degrees. When you flip through these pictures quickly 
enough, the wheel appears to spin. 

GRAPHICAL OPERATIONS - 
THE SCREEN OPERATOR 

The ST computers allow about 16 built-in drawing logic oper- 
ations. In other words, when you are moving bit-images 
around (or drawing lines, or whatever) you may specify a log- 



ical operation to be performed between what you're moving 
and where you're moving it to. By "logical operation" 1 mean 
the ability to apply the logic operators NOT, AND, OR, 
Exclusive-OR, or any combination of those, to bit-images you 
are moving. The old edit-compile-crash cycle gets in the way 
of playing "what if?" when experimenting with this effect, so 
this accessor)' will allow you to perform logical operations be- 
tween entire screens, or between a source and mask, with a 
separate destination. Notice this will allow you to physically 
add or subtract one picture from another. It's actually quite 
simple. You can now OR one picture into another, or create 
entirely electronic matte shots for computer animation. 

CREATION AND INSTALLATION 

All the files you'll need are contained inside the file 
TOOLKIT.ARC on your START Disk. Copy TOOLKIT.ARC 
and ARCX.TTP over to a clean, fresh disk. Double-click on 
ARCX.TTP and in the resulting "Open Applications" box type 
TOOLKIT.ARC and press the Return key. ARCXTTP will 
reconstruct and uncompress all the available files from the 
original TOOLKIT.ARC file 

When ARCX is finished, you should find two recon- 
structed Accessories, their Resource Files and all source code 
written to your disk. Find, and copy, the four files 
PAGEFLIRACC, PAGEFL1PRSC, OPERATOR.ACC, and OPER- 
ATOR.RSC over to a disk you will be booting from later. Insert 
this disk into your first disk drive, turn your ST computer off, 
count to fifteen (slowly), and then turn it back on. 

Your ST will recognize and load the two Accessories 
PAGEFL1P and OPERATOR when it powers up. When your 
desktop appears, insert your DEGAS Elite disk and double- 
click on DEGAS Elite. Yes, it is possible to select the two Desk 
Accessories before DEGAS Elite is activated, but if you do 
they will simply scold you for trying to use them without 
DEGA5 Elite being active. When DEGAS Elite powers up, the 
two Accessories are now available. Go up to the DESK menu 
item and check the drop-down menu. The two should be 
labeled there as "Page Flipper" and "Screen Operator" 

FLIPPING THE FLIPPER 

Let's explore the Page Flipper first. Before you activate it, draw 
eight simple frames of animation in DEGAS Elite. For my ini- 
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rial tests, I simply numbered each of the display screens. Now 
go up and click on "Page Flipper" from the DESK menu selec- 
tion. You'll see a single Dialog Box pop up in the center of the 
screen. Refer to Figure 1 during the rest of the description of 
the Page Flipper Dialog Box. 

Along the top you'll see the title. Below that, stretching full 
width across the Dialog is the Sequence Window, showing 
which frames you've selected, and in which order they will 
show. You have room for up to 44 frames in a sequence. 
Directly below the Sequence Window are eight buttons you 
use to select which frame to show. For example, when you 
press the 121 button, a "2" is inserted into the Sequence win- 
dow at the first available space. If you have fewer than eight 



Another way 

to do animation is to 

draw every picture beforehand, 

and then flip through them 

at a fast clip. 



screens available, only the buttons corresponding to available 
screens will be active Below the Frame selection buttons are 
two buttons to allow simple editing of the Frame Sequence. 
The 1CLEAR1 button erases the current frame sequence, and 
the (BACKSPACE! button erases the last entry in the frame se- 
quence. Underneath the two editing buttons is the Frame 
Speed control slider, which allows you to control how long 
each individual frame is shown onscreen. Slide the control 
Wt or right, or click-hold on either slider "thumb" to increase 
or decrease display time. The resultant computed display 
time will be shown inside the track of the slider Finally, be- 
low the slider are two buttons. The [PERFORM! button will 
actually perform the Page-Flipping animation routines, with 



the (EXIT1 button dropping you back onto the DEGAS Elite 
desktop. 

OPERATING THE OPERATOR 

The Screen Operator is shown in Figure 2. As with the Flip- 
per, the program title is along the top. Below the title box 
you'll find three screen selection boxes, each showing a single 
number with a "decrease" and "increase" thumb on either 
side. The left box shows the current selection for the SOURCE 
screen, the middle box shows the MASK screen selection, and 
the box on the right shows the current DESTINATION screen 
selection. Click on the Up arrow to increase these numbers, 
and click on the Down arrow to decrease them. 

Below the screen selection boxes is a large box showing 
the logical operations you can perform. It's easy to follow the 
sequence of operations available. You may choose to NOT the 
source screen if you desire, then AND, OR, or EOR the screen 
against the DESTINATION, or against the MASK screen if you 
have the IWith MASKI button selected. Finally, you may 
choose to NOT the destination screen before you set the re- 
sult down. Right below the Operations Box there are three 
buttons, IEXITI, IVIEW) and [PERFORM!. IPERFORM1 will ac- 
tually do the operations between screens you've selected 
above. You'll see it perform right on the screen, but it goes 
fast, so if you miss it, and still want to see the results, point at 
the IV1EWI button, then press and hold the left mouse button 
for as long as you wish to view the results. The IEXITI button 
will drop you back to the DEGAS Elite desktop. 

THE BEELY OE THE BEAST 

If you just want to use the Toolkit Accessories, and don't 
really care about how they're put together, you can skip the 
balance of this article. The rest of you, however, may read on. 

Again, let's start with the Page Flipper. You'll need to refer 
to the program on your START disk called PAGEFL1P.C . The 
very top of the file has a block of comments showing the 
author's name and copyright information. Below that are 
■^includes for five standard header files and one unique fife, 
pageflip.h, which was generated by the Resource Construc- 
tion Set when the resource file was created. 

Next, find a block ol #detine statements, to allow 
modification of the supporting language and the definition of ► 



STart. The ST Quarterly 



25 



manaainam 



Toolkit. 




Using the Screen Operator you cat 



constant values and constructions into meaningful names. In 
the variable definitions area, you'll first come across the only 
externally defined value you'll need to reference, called 
gl_apid, which stands for "global application ID," and 
represents the application's identification number. For in- 
tegers, save space for box sizes, activity Hags, and our message 
buffer 

There is only one warning string and space for the se- 
quence buffer in the byte-sized declarations. Save space for 
three longs, including a single array of 15 longs to hold the 
screen pointers, and keep space for two floating point arrays, 
needed for the slider calculations. Oh, keep a single pointer 
to an OBJECT type, too. 

A CODE IN THE NODE 

In the mainf ) function, first initialize the application, get the 
handle of the accessory from graf_handle( ), and then regis- 
ter our accessory inside the menu_register( ) call. It returns 
to us the number of our accessory, and stores the result inside 
the variable called menu_id. Next, it tries to load the re- 
source file for the page flipper If for some reason it can't, it 
warns you of impending danger 

Otherwise, it loads the resource successfully, and finds out 
where it wound up in memory with the rsrc_gaddr() call, 
on the next line down. The address of the root of the object 
tree will be returned, and the program places it inside the 
variable dialogO. Since it's now gotten the resource file and is 
holding it in memory, it can find out how big some of the ob- 
jects inside it are. It does that in the next block of code down, 
using objc_offsetO to find the location and size of three 
windows you'll eventually need to redraw without disturbing 
anything else inside the resource. Then it erases the current 
queue ior holding the frame sequence to show, and places a 
single default frame, number one, into the buffer. 

ACCESSORIES NEVER QUIT 

Here's where the main block of code is. Notice there is no exit 
from the next loop. Why? Accessories never finish (rather 
they're not supposed to), so they can have no exit. Anyway, 
here it just needs to do two things-one, wait for a message 
which says you have selected the accessor)' to operate, and 
two, wait for a message coming from DEGAS Elite which 



returns where the screens actually are 

The program waits for messages inside an evnt_multi( ) 
call. When one is received, it goes into msgbuffll, and falls 
down to the next available test, which decides if the message 
it received was from the screen manager telling it you have 
asked the accessory be opened. If not, it then tests if the mes- 
sage received was from DEGAS Elite telling it where every- 
thing is. If that wasn't the message, it disregards it. 

If the message was from the screen manager, asking the ac- 
cessory to open, it makes one further check to see if the mes- 
sage really is for the accessory, by comparing the menu ID 
number it received earlier. If they match, then open the virtual 
workstation, and then call the function inquiref), which will 
send a message to DEGAS Elite asking it to send the location 
where DEGAS Elite keeps its screen pointers. When it 
returns from that call, close the workstation, and fall back 
into the multi call, waiting for the answer from DEGAS Elite. 

When DEGAS Elite responds to our request, it will send 
the accessory a message. The accessory will detect that mes- 
sage, open the workstation again, pick up the current horizon- 
tal and vertical resolution, and then call the function menu_ 
handle(), which performs the main body of work here. 
When it finally does finish the work, it will return to this 
point when you click on the 1EXIT1 button located right on 
the dialog box. 

INQUIRING MINDS WANT TO KNOW 

The next function, inquiref), gets called when the accessory 
first opens up. It first decides if DEGAS Elite is even available, 
by testing for its application number. If the number can't be 
found, it will scold the user and drop out. If the number is 
tound, inquire( ) will send a message to DEGAS Elite with the 
appl_write( ) call, sending it a string of sixteen characters 
containing the DEGASOO instruction, asking for the pointer to 
the screen pointers. 

A HANDLE ON THE SITUATION 

The function here that performs the major body of work is 
called menu_handle(). which starts by dynamically deter- 
mining the comers of a small centered box onscreen. Next, 
using the information returned to us from DEGAS Elite, we 
determine exactly where in memory the master pointer to the 
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list of screen pointers is that DEGAS Elite keeps. We place the 
address of the master pointer inside the variable s_ptrs. Us- 
ing that information, we then access and retrieve each avail- 
able pointer and place them inside the long array screen!]. 

Next, execute wind_update( TRUE ), as we're about to 
start writing to the screen. The two form_dial() calls will re- 
serve space for the dialog box and grow the expanding rec- 
tangle onscreen. Next, determine the condition of the graphic 
buttons inside the dialog box, and set them accordingly Fi- 
nally, draw the dialog box onscreen with the objc_draw( ) 
call, passing in the address of the root of the object tree, the 
maximum level of children to draw, and the box's clipping 
rectangle. 

Before you actually interact with the dialog, you'll need to 
tidy up the displayed numbers and strings inside the box. 
The program will then encounter the DO loop, which takes 
on the task of interacting with the dialog box itself. Start by 
calling the form_do() function, which will handle button 
presses and so forth in the dialog box, and then return the 
number of the object which caused the exit from the dialog 
box. Put this number inside the variable keyl. 

Next, perform three tests. If the exit button pressed was 
BPERFORM, which is the [Perform! button inside the dialog 

box, perform the function flip it( ), and then reset the state 

of the [Performl button. If the exit button was one of the se- 
quence buttons, or one of the sequence editing buttons, drop 
through to the function filter_key(), which will perform any 
action requested by that particular key. If the exit button 
pressed was a key coupled with the slider function, then per- 
form the function do_slider(). Continue in the DO loop for 
as long as the user doesn't press the BEXIT (the onscreen 
EXIT!) button. 

When the user really does wish to exit, redraw the dialog 
box without any selected buttons, drop through the two last 
form_dial() function calls to release the memory for the 
resources and draw the shrinking box outline, then reenable 
GEM drawing of the screen with wind_update( FALSE ), 
and return to the main multi loop. 

THE STATE OF THE BUTTONS 

The first section here will figure out how large sections of the 
dialog are, so the program may build a set of clipping rec- 
tangles for when it will need to update and redraw these ob- 
jects. The second section sets the initial state of the sequence 
selection buttons, showing whether or not the screens they 
represent are actually available from DEGAS Elite. If the as- 
sociated screens are available, then the buttons are drawn as 
SHADOWED; if not, they're drawn as DISABLED. 

Next, in flip__it(), decide first if there are any frames to 
flip through. If there are, then point to each one in turn and 
display it onscreen. Once the frame is displayed, delay for the 
length of time the user has selected with the speed slider, 
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synching to the vertical blank interrupt to get even timing. 
Continue to do this as long as the user hasn't pressed the but- 
tons on the mouse. When a button is pressed, drop out of the 
display loop. Towards the bottom, if there are no frames to 
display, then ask the user to place at least one single frame in 
the sequence buffer 

The next function down, filter_key(), receives the key- 
stroke pressed inside the dialog box and decides what to do 
with it. For example, if the key pressed was the B8 key (which 
corresponds to the 181 key onscreen,) the proper routine in- 
serts the character "8" into the frame sequence, and then dis- 
plays it onscreen. 

The next two functions are related. The first, adjust(), 
takes as parameters the address of the dialog box, the number 
of the object holding the string to change, the address of the 
new string to use, and the comers of the clipping rectangle for 
that particular object. The second, set_text( ), actually per- 
forms the work of inserting the address of the new string in- 
side the object tree. 



The ST 

computers allow 

about 16 built-in drawing 

logic operations. 



UTILITIES 

To aid in moving strings around, two functions, strcat(), and 
strlen(), are provided to allow concatenation of strings and 
the finding of the length thereof. The next function, reset(), 
provides the initial settings for the horizontal slider which 
controls display speed, while the one below, do_slider(), 
performs the proper work when you press the slider 
"thumbs" or click-drag the slider button. 

DOWSING THE OPERATOR 

Now we get into the Screen Operator. Print out and refer to 
the program OPERATOR.C on your START disk. The top of 
the file has a block of comments showing who wrote the pro- 
gram and copyright information. Below that it #includes five 
standard header files and one unique file, operatorh, which 
was generated by the RSC when the resource file was created. 

Next, find a block of #define statements, to allow 
modification of the supporting language and the definition of ► 
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Toolkit. . . 

constant values and constructions into meaningful names. In 
the variable definitions area, you'll first come across the only 
externally defined value you'll need to reference, called 
gl_apid. which stands for "global application ID", and 
represents the application number For integers, save space for 
box sizes, activity flags, and our message buffer 

We hold only one warning string and space for the se- 
quence buffer in the byte-sized declarations. We save space 
for three longs, including a single array of 15 longs to hold the 
screen pointers, and we keep space for a single pointer to an 
OBJECT type. 

TH£ MAIN SECTION 

In the main() function, we first initialize the application, get 
the handle of our accessory from graf_handle( ), and then 
register the accessory inside the menu_register( ) call. It 
returns the number of the accessory, and will store the result 
inside the variable called menu_id. Next, try to load the re- 
source file for the screen operator. If for some reason it can't, 
then warn the user of impending danger 

Otherwise, load the resource, and find out where it wound 
up in memory with the rsrc__gaddr( ) call, on the next line 
down. The address of the root of the object tree will be 
returned, and you'll need to place it inside the variable 
dialogO. Next, make sure all the button flags are turned off, 
and select the default settings for the source, mask, and desti- 



nation pictures. Show the mouse, and then fall into the 
evnt_multi( ) loop. 

THERE'S NO WAY OUT 

Here's where all the work is done. Notice there is no exit from 
the next loop. Why? Accessories never "finish", so they can 
have no exit. Anyway, here it just needs to do two things. 
One, wait for a message telling it you've selected the accessory 
to operate, and two, wait for a message coming from DEGAS 
Elite telling it where the screens are. 

The accessory will wait for messages inside an 
evnt_muki() call. When one is received, it goes into 
msghuffl], and it will fall down to the next available test, 
which decides if the message received was from the screen 
manager asking the accessory be opened. If not, test if the 
message received was from DEGAS Elite saying where every- 
thing is. If that wasn't the message, disregard it. 

If the message was from the screen manager, asking the ac- 
cessory to open, then make one further check to see if the 
message really is for the accessor)', by comparing the menu ID 
number it received earlier If they match, then open our vir- 
tual workstation, and then call the function inquireQ, which 
will send a message to DEGAS Elite asking it to send the loca- 
tion where DEGAS Elite keeps its screen pointers. When the 
accessory returns from that call, close the workstation, and 
fall back into the multi call, waiting for the answer from 



FIGURE 1 



FIGURE2 



DEGAS Elite Toolkit 
Page Flipper 



1ES45673 




DEGAS Elite Toolkit 
Screen Operations 




STaht, The ST Quarter!) 



28 Summer, 1987 



■M,lil,MIIJ!IIM 



DEGAS Elite. 

When DEGAS Elite responds to the request, it will send 
the accessor)' a message. The accessor)' will detect that mes- 
sage, open the workstation again, pick up the current horizon- 
tal and vertical resolution, and then call the function 
menu_handle(), which performs the main body of work 
here. When the accessory finally does finish the work, it will 
return to this point when you click on the [EXIT] button lo- 
cated inside the dialog box. 

JUST ASK DEGAS, HE KNOWS EVERYTHING 

The next function, inquireQ, gets called when the accessory 
first opens up. It first decides if DEGAS Elite is even available, 
by testing for its application number If the number can't be 
found, scold the user and drop out. If the number is found, 
send a message to DEGAS Elite with the appl_write() call, 
sending it a string of 16 characters containing the DEGASOO 
instruction, asking for the pointer to the screen pointers. 

The function here which performs the major body of work 
is called menu_handle(), which starts by dynamically deter- 
mining the corners of a small centered box onscreen. Next, 
using the information returned to us from DEGAS Elite, we 
determine exactly where in memory the master pointer to the 
list of screen pointers is that DEGAS Elite keeps. We place the 
address ot the master pointer inside the variable s_ptrs. Us- 
ing that information, access and retrieve each available 
pointer and place them inside the long array screenll. 

Next, execute wind_update( TRUE ), as you're about to 
start writing to the screen. The two form_dial( ) calls will re- 
serve space for the dialog box and grow the expanding rec- 
tangle onscreen. Next, determine the condition of the graphic- 
buttons inside the dialog box, and set them accordingly. 
Finally, draw the dialog box onscreen with the objc_draw( ) 
call, passing in the address of the root of the object tree we 
wish drawn, the maximum level of children to draw, and the 
box's clipping rectangle. 

Before the user actually interacts with the dialog, you'll 
need to tidy up the displayed numbers and strings inside the 
box. Next comes the DO loop, which takes on the task of in- 
teracting with the dialog box itself. Start by calling the form_ 
do() function, which will handle button presses and so forth 
in the dialog box, and then return the number of the object 
which caused the exit from the dialog box. Put this number 
inside the variable keyl. 

Next, perform three tests. If the exit button pressed was 
BPERFORM, which is the IPerforml button inside the dialog 
box, perform the function operate(), and then reset the state 
a\ the IPerforml button. If the exit button was one of the oper- 
ation buttons, drop through to the function filter_key(), 
which will perform any action requested by that particular 
key. Continue in the DO loop for as long as you don't press 
the BEXIT (the onscreen IEXIT]) button. 



When you really do wish to exit, drop through to the two 
last form_dial( ) function calls to release the memory for the 
resources, and draw the shrinking box outline, then reenable 
GEM drawing of the screen with wind_updatc( FALSE ). 
and then return to the main multi loop. 

BUTTON INITIALIZATION 

The first section here will figure out how large sections of the 
dialog are, so it may build a set of clipping rectangles for 
when it needs to update and redraw these objects. The sec- 
ond section sets the initial state of the operation selection 
buttons, showing whether or not the buttons they represent 
are active. It the buttons are active, they're drawn SELECTED, 
it" not, they're drawn NORMAL. 

The next function down, filter_key( ), receives the key- 
stroke pressed inside the dialog box and decides what to do 
with it. For example, if the key pressed was the SRCDN key 
(meaning you want it to decrement the source picture num- 
ber), the proper routine first makes sure the screen number is 
above one, and if it is, then decrements the number. It then 
converts the new screen number into a string, and calls a 
function which will insert the new string into the source pic- 
ture number box. The AND, OR, and EOR buttons are mutu- 
ally exclusive, meaning if you select one of them, it will make 
sure the other two are turned off. 

The next two functions are related. The first, adjust(), 
takes as parameters the address of the dialog box, the number 
of the object holding the string to change, the address of the 
new string to use, and the comers of the clipping rectangle for 
that particular object. The second, set_text( ), actually per- 
forms the work of inserting the address of the new string in- 
side the object tree. To aid in moving strings around, two 
functions, strcatQ and strlen(), are provided to allow con- 
catenation of strings and the finding of the length thereof. 

THE FAT LADY SINGS 

Cleverly designed inside these two utilities is the method for 
installing your own GEM accessories. Throw most of my code 
away and build your own. I've only demonstrated one aspect 
of communication with the inside of DEGAS Elite. You have 
the ability to change and set colors, move, define, and 
manipulate blocks ol graphics data, and more. 

What can you do on your own? How about edge detec- 
tion? Contrast stretching? 1 want somebody to write me a 
rubber-box source code generator for either C or assembly, or 
a way to combine two DEGAS pictures tor a full page prin- 
tout. Get to work-and soon we'll see a flood of Desk Acces- 
sories for DEGAS. ■ 

IF YOU'D LIKE TO SEE MORE ARTICLES LIKE THIS ONE, 
CIRCLE 185 ON THE READER SERVICE CARD. 
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Sagan! Even if you 
can 't say ' 'billions 
with a plosive "b," 
you can still pick out 
those bits of star stuff 
from the rest of the 
cosmos. All you need 
to find your way 
around the night sky is 
a clear view, your ST 
and the aSTronomer, a 
universe-mapping pro- 
gram you 'II find on 
your START disk. 



As an amateur astronomer, 
the last thing I want to do 
before an evening of observ- 
ing is to leaf through an astronomical 
magazine or almanac, searching for 
planetary positions, star maps, and 
other such items, I also don't care to 
spend five hours wading through mas- 
sive spherical trigonometry formulas to 
get the information 1 want. Wouldn't it 
be easier, I thought, just to run a pro- 
gram on my ST, enter the current date 
and time, and in a matter of minutes 
have star maps and printouts of plane- 
tary positions? This is how the 
aSTronomer was born. 

The aSTronomer is an easy-to-use 
GEM-based program written in Personal 
Pascal. 1 chose Personal Pascal because 
of its extensive support of GEM, and 

aFile ASTRO.ARC 
on your START disk 



wrote the program with the user in 
mind. All keyboard input is done using 
dialog boxes, which helps eliminate in- 
advertent errors (such as entering a 
string when an integer is asked for), and 
all questions the program asks are an- 
swered with alert boxes. All program 
output can be sent to either the screen 
or the printer (which you can configure 
from a menu option). The program also 
works in both medium and high reso- 
lutions. 

The aSTronomer can do many things 
that an amateur astronomer will find 
useful, and things that a beginner will 
find educational. With a few clicks of 
the mouse you can: 

• select the latitude and longitude of 
your observing site anywhere on the 
Earth; 

• select the time and date you want in- 
formation for, over 100 years in the 
future, or hundreds of years in the 
past; 

• print the positions of all the planets, 
Moon, Sun and nine different 
comets; and 

• draw three different types of star 
maps, accurate and ready to use! 

THE OLDEST SCIENCE 

The science of astronomy is an ancient 
one. Since earliest times, man has won- 
dered about the twinkling lights in the 
sky-why some of them moved as 
others remained stationary, why the 
Moon appeared to grow and shrink in 
size each month, and why the Sun 
seemed to disappear occasionally, swal- 
lowed by a blackened disk with a shim- 
mering halo in an eclipse. 

Ancient civilizations began to record 
such celestial events in calendars, and 
began formulating ideas about how the 
universe was structured. One noted 
Greek astronomer, Hipparchus, mapped 
the constellations and estimated the 
brightness of the stars; another, Ptolemy, 
devised the Earth-centered view of the 
universe, where everything, including 
the Sun, planets and stars revolved 
about the Earth. 



The ideas of the early Greeks stayed 
with us for nearly two thousand years 
until the Renaissance, when Coperni- 
cus, Kepler and Galileo gave us a more 
accurate understanding of how the uni- 
verse is structured. Since then, discover- 
ies such as the planets Uranus, Nep- 
tune, and Pluto, the rings about Uranus 
and Jupiter, the explorations of the 
planets and the Moon by both U.S. and 
Soviet probes, and the periodic hype 
surrounding Halley's Comet have kept 
astronomy in the public's eye, and 
powerful radio-telescopes constantly 
scan the skies lor new discoveries. But 
even after thousands of years there's still 
plenty for an ordinary person to see! 

Many people living in large cities 
have never really taken the time to ap- 
preciate the beauty of the night sky. For 
most of them, a simple trip to the coun- 
try with a pair of binoculars (or even 
just the naked eye) is enough to open 
the grandeur of space for them. With an 
Atari ST computer, the aSTronomer 
should help you see ahead of time what 
celestial items of interest are worth 
looking for, and to continue the fascina- 
tion with the night sky that has been 
with us since man first appeared on 
Earth. 

WHAT'S UP, DOC? 

First, a few terms and facts. 

What's up there? You've seen the Sun 
and the Moon; only a little more 
difficult to spot are the planets. The 
planets look like stars, but they seem to 
move slowly around the sky from week 
to week- and they don't twinkle as the 
stars do. The planets Mercury and 
Venus are known as either "morning 
stars" or "evening stars"; they seem to 
stay close to the Sun, and are usually 
the first or last objects you'll see in the 
night sky (more often Venus than Mer- 
cury, since Venus is far brighter). Jupiter 
usually dominates the night sky, be- 
cause it is also a very bright planet. 
Saturn is a visual feast because of its 
rings-you can see them easily with all 
but the smallest telescopes! Mars is oc- ► 
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casionally bright enough to be domi- 
nant in the night sky and presents 
many interesting views (though, con- 
trary to tradition, there are no canals or 
Martians to speak of!). The other 
planets in the Solar System are usually 
too faint to be seen easily by beginning 
astronomers. 

Also in our Solar System are comets 
and meteors. Comets are "dirty snow- 
balls," as Halleys Comet was so affec- 
tionately described: large balls of dust, 
ice and gasses, which hurtle toward the 
sun and then fly back out to deep space 
on a regular cycle. (There are a few 
comets, such as Encke, which have or- 
bits similar to the planets.) 

Meteors are usually called "shooting 
stars," and can be seen on practically 
every night of the year as bright streaks 
of light. On certain nights of the year, 
tens or even hundreds of meteors may 
be seen per hour at night. These dis- 
plays are called "meteor showers"; they 
happen when the Earth passes through 
clouds of dust and debris left behind by 
the passage of comets. An excellent 
shower for the northern hemisphere oc- 
curs each year around August 11. Called 
the Perseids, since the meteors radiate 
outward from the constellation Perseus, 
this shower can produce up to 60 
meteors per hour if you watch it in a 
dark site out in the country. Meteors are 
easy to watch, since all you need is a 
lawn chair and a blanket to keep warm! 



o 



ccasionally, if you live far 
enough north or south of 
the equator, you may be 
able to catch aurorae (northern or 
southern lights). Unfortunately, these 
are not easy to predict, since they de- 
pend on magnetic activity in the Sun. 

Einally, there are the stars. With 
binoculars, thousands of extra stars are 
visible, and in a clear sky the Milky 
Way is especially breathtaking to scan 
with binoculars. If you look closely 
enough, lots of stars that seem to be sin- 
gle to the naked eye turn out to be dou- 
ble or triple (an example of this is the 
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second star in the handle ol the Big 
Dipper a double known as Mizarand 
Alcor). With a larger telescope, it's easy 
to study nebulas and galaxies. It be- 
comes apparent, with just a sweep of 
the sky with a pair of binoculars, that 
there is much more to the sky than 
twinkling stars-that there's literally a 
whole universe just waiting to be exam- 
ined by those who will take the time. 

STAR TALK 

Before we get into the program, a little 
astronomical jargon. First, you can 
specify where stars are either by their 
altitude and azimuth or by their right 
ascension and declination. 

The altitude is the angle above the 
horizon. At the horizon, the altitude is 
zero; halfway up, the altitude is 45 
degrees; directly overhead, the altitude 
is 90 degrees. The azimuth is the com- 
pass direction-zero degrees is north, 
90 degrees is east. 180 degrees is south, 
and 270 degrees is west. 

A handy rule of thumb is that a 
clenched fist held out at arm's length is 
about ten degrees across. Thus if (at a 
particular time) Venus is at 20 degrees 
altitude, 260 degrees azimuth, you 
would face almost due west and look 
for Venus about two fists up from the 
horizon. 



Another system is equatorial coor- 
dinates, using declination and right 
ascension. To get an idea of how they 
work, imagine that the sky and the 
earth are giant concentric globes, both 
turning on the same axis. Just like the 
earth, the sky has an equator, a north 
pole and a south pole It also has lati- 
tude lines running parallel to the equa- 
tor, and longitude lines running from 
pole to pole. 

The latitude lines are called declina- 
tion (abbreviated Dec). Like regular lati- 
tude, it's the angular distance Irom the 
equator-up to 90 degrees north or 
south. Zero degrees declination is 
directly above the equator, while 90 
degrees north is directly above the 
north pole, and 90 degrees south is 
above the south pole. 

The longitude lines are called right 
ascension (abbreviated R.A.). Instead ol 
being measured in degrees, it's mea- 
sured in hours, minutes and seconds; 
the distance all the way around the 
"globe" of the sky is exactly 24 hours, 
and the zero point is located in the con- 
stellation Pisces. 

Equatorial coordinates are used 
mainly for plotting star maps. The aS- 
Tronomer's Star Atlas menu option lets 
you choose a right ascension and decli- 
nation to see what objects are in any 
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section of the sky. 

Astronomy also has two ways of 
keeping track of time: Universal time 
and Sidereal time. Universal time (ab- 
breviated UT) is just Greenwich Mean 
Time— the current time at the observa- 
tory at Greenwich, England. By quoting 
times in one known time zone, it's easy 
to convert times for other locations. For 
instance. Eastern Standard Time is five 
hours earlier than UT; thus 7 RM. EST is 
midnight UT. 

Sidereal time, or "star time," is just the 
right ascension of whatever star is 
directly overhead. Remember, depend- 
ing where you are, a different set of stars 
will be directly overhead at any given 
time, so sidereal time is not an efficient 
way of reporting astronomical events; 
it's usually used For orienting large tele- 
scopes to locate particular stars. 

This isn't a complete introduction to 
astronomical terms, but it should make 
it a little easier for you to use the 
aSTronomer. Now, on to the program! 

RUNNING THE 
PROGRAM 

To run the aSTronomer, first un-ARC the 
files in ASTRO. ARC. Then create a new 
folder named ASTRONOMY, and copy 
HELP.DOC and the six .DAT files into 
the folder. Finally, double-click on 



ASTRONMYPRG, and you're read)- to go. 

The first time you run the program, 
just try this: Under the Location menu 
set the location to your own latitude 
and longitude, and with the Clock 
menu set the date and time (remember, 
it's in Universal time). Now choose Sky 
Plot from the Almanac menu, and your 
ST will plot a view of the sky on your 
screen. By pressing Alt-Help, you can 
print the map on your printer. 

That may be all you'll ever need the 
aSTronomer for- but there's more infor- 
mation in the other menu options . You 
can explore the program by moving the 
mouse across the menu bar, and as you 
do, you'll learn a lot more about as- 
tronomy, too. 

THE MENU OPTIONS 

Desk 

the aSTronomer- show program in for- 
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Print Out-toggle printer output for 
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dumps 

White Screen -toggle white-on-black or 
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Help File-get on-line help 
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Location 

Latitude-enter latitude in degrees, 
minutes and seconds North or South 
Longitude -enter longitude in degrees, 
minutes and seconds East or West 

Clock 

Date-set date 

Time (UT)-set time in Universal time 

Almanac 

Solar System -calculate table of posi- 
tions for solar system 
Sky Plot -plot star map as Horizon Map, 
Zenith Map, or Star Atlas 

Most of the options are 
straightforward. Remem- 
ber that you must set the 
time to UT, not your local time. In New 
York, add five hours to your local time; 
in Chicago, add six hours; in Denver, 
add seven hours; in San Francisco, add 
eight hours; and in Saudi Arabia, sub- 
tract four hours. 

The Sky Plots may take a minute or 
more because so much data must be 
manipulated. There are three different 
versions: Horizon Map, Zenith Map, and 
Star Atlas. 

The Horizon Map lets you choose a 
direction to look (the azimuth) and 
then displays the sky as it appears from 
the horizon up to 60 degrees altitude. 
The Horizon Map also superimposes 
the positions of the planets, comets. 
Sun and Moon on the star map. 

The Zenith Map shows the entire sky 
at once (this is the type of map that's 
published in newspaper astronomy 
columns). If you use black stars on a 
white screen, it's easy to print out the 
Zenith Map using Alt-Help. It's one of 
the easiest ways to get a star chart to 
compare with what you see in the sky. 

Finally, the Star Atlas is a highly- 
detailed star map. Unlike the Horizon 
and Zenith maps, the Star Atlas just 
gives you one section of the sky, which 
you specify by right ascension and 
declination. The sample coordinates 
will create a star plot of the constella- 
tion Orion and the area around it. ► 
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Whether you own an 8-bit Atari computer or one of the new STs, 
you need the power of a magazine designed especially for you. 



FOR THE 

8-BIT ATARI 

AND ST USER 

ANTIC, the Atari Resource, the lead- 
ing Atari publication for five years, is still 
the undisputed champion. Every month it ' 
delivers powerful articles, knock-out programs, 
and punchy product reviews. 

To save you all that tedious typing, Antic will supply 
you with a monthly disk for your 8-bit, chock-full of 
useful programs, great games, and utilities. 

Subscribe to ANTIC, the Atari Resource, and win! 
Twelve times a year, ANTIC shows you how 
to get the most out of 
your Atari, and have fun, 
too. A full year of ANTIC 
(12 issues) is just $28. 
Or treat yourself to 
the Action Edition 
(12 issues plus 12 
disks) for 
k $99.95. 



JUST FOR 
i THE NEW ST 

- S7VWT, the ST Quarterly, is the 
leading contender in the ST field. 
A trailblazer, START gets the points 
for its indepth reviews, challenging tutorials, and 
/ inside tips from the biggest names in the Atari world. 

Every issue contains a 3V2" disk packed with amazing 
programs and utilities that will simply knock you out with 
their convenience and power. 

Pick the winning combination by subscribing to Stafirplus 
ANTIC. For just $59.95 receive four issues of START with disk 
plus twelve monthly issues of Antic with its invaluable 
ST Resource section. Stay up-to-the-minute with new 

products, new developments, new programs, 

new information. 

Or subscribe just to START, the ST Quarterly for only $39.95 



STart your subscription today! 

Antic- Publishing, Inc. 544 Second Street San Francisco, CA 94107 

New Subscriptions Only Call 800-443-0100 Ext.133 
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That's how to use the aSTronomer As 
1 said before, it's fun to experiment; you 
can see the results of plots made an 
hour apart, or a day apart, or a month 
apart. With this program, it's extraor- 
dinarily easy to create a map of exactly 
the night sky you want to look at. 

SPECIAL FEATURES 

The formulas used in this program are 
standard astronomical and spherical 
trigonometry. For those interested in 
learning more about the formulas used, 
consult books such as Practical Astron- 
omy with Your Calculator, by Peter 
Dufiett-Smith (Cambridge University 
Press, 1979), or The Observer's Handbook 
(University of Toronto Press, yearly). 
Since Personal Pascal doesn't have 
any built in functions to convert from 
numbers to strings arid vice versa, 1 had 
to devise my own. The more useful of 
the two functions turned out to be Val 
(Snumber : string) : real, which con- 
verted the string Snumber into a real 
number This was needed since the data 
returned by dialog boxes are in string 
format, and I needed a way to convert 
those strings to numerical data. Also, all 
the data in the files in the 
ASTRONOM.Y folder are in text format, 
and I needed a way to convert them 
from text to real number format. 



The other useful procedure was my 
version of the C function itoa(), itoa 
(x : integer; var s : string), which con- 
verts an integer (positive or negative) 
into a string of length up to six. 1 
needed this to convert the system date 
and time into strings for the date and 
time dialog box delaults and for the 
table of Solar System data. 

Other features include the use of 
BIOS, XBIOS and GEMDOS calls 
directly in the Personal Pascal code. 
This allowed such things as accessing 
the system date and time, getting the 
resolution of the screen, setting the 
printer port and getting single key input. 
Also, the built in VT-52 emulator in the 
Atari ST computer came in handy for 
the PrintAt (x,y ; integer) procedure, 
which was used to place the cursor at 
an (x.y) position on the screen. 

For the plotting routines (in the Sky 
Plot section), the Horizon Map plotting 
routine is quite simple to understand. 
The horizontal azimuth coordinates are 
compared to the limits of the horizon to 
be plotted, and the altitude coordinates 
are checked to see that they are between 
and 60 degrees. It is then a straight 
translation of those coordinates into 
(x,y) plotting coordinates. 

The Zenith Plot is slightly more com- 
plicated. It takes the horizontal coor- 
dinates from the star database called 



CONST.DAT. It then converts those 
coordinates (which are, in mathematics, 
just polar coordinates) into Cartesian 
coordinates, which are easy to scale to 
the screen resolutions. 

The Star Atlas was by far the hardest 
to accomplish. It involves taking the 
equatorial coordinates of the large star 
databases (called S_RA.DAT, S_ 
DECDAT and 5_MAG.DAT) and con- 
verting those spherical coordinates into 
three-dimensional Cartesian coor- 
dinates (x,y,z). These coordinates are 
first rotated in the (xy) plane by an 
angle equal to twelve hours right ascen- 
sion minus the right ascension of the 
window center. Then the coordinates 
are rotated in the (x,z) plane by an 
angle equal to the declination of the 
window center. 

The three dimensional coordinates 
are then reconverted back to right 
ascension and declination (equatorial 
coordinates), and a simple conversion 
routine plots the stars onto the screen 
without distortion. The rotations must 
be performed; otherwise you get an un- 
acceptable amount of distortion as you 
plot closer and closer to the north and 
south celestial poles. (It's like the distor- 
tion you find on a Mercator map of the 
world, which always shows Greenland 
much larger than Australia, whereas the 
opposite is true.) The rotations make it 
possible to plot the sky as if it were 
centered about 12 hours right ascen- 
sion, degrees declination, which can 
be plotted easily without distortion. 

For these rotations, all angles are 
calculated before entering the 
loop that goes through the en- 
tire star database, and thus speeds up 
plotting. Unfortunately, since rotations 
invariably use trigonometry functions 
(sines and cosines), plotting slows 
down, but not tremendously. The stars 
are plotted in relation to their bright- 
ness (that is, the brighter the star, the 
larger the dot that is plotted). This is 
done by comparing the magnitude of 
the star from the large star database. ► 
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ASTRONOMER... 

THE DATA FILES 

The PLANETS.DAT file is a sequential 
data file consisting of the orbital ele- 
ments of each of the planets in the Solar 
System. Each planet has an entry which 
is structured as follows: name, period of 
revolution (years), longitude at the start 
of 1980 (degrees), longitude of closest 
approach (degrees), eccentricity of the 
orbit, semi-major axis of the orbit (as- 
tronomical units), inclination of the or- 
bit (degrees), longitude of the ascending 
node (degrees), angular size at one as- 
tronomical unit (arc seconds), and a 
brightness factor A good astronomical 
manual can further explain each of the 
above orbital elements. 

The COMETS.DAT file is also a se- 
quential data file with the following 
structure: name, year of closest ap- 
proach, longitude of closest approach 
(radians), longitude of ascending node 
(radians), period in years, semi-major 
axis (astronomical units), eccentricity of 
orbit, and the inclination of the orbit 



(radians). The cometary data is, unfor- 
tunately, very prone to obsolescence, 
since the larger planets, Jupiter and 
Saturn, have enough gravitational pull to 
change the orbital elements from time to 
time. If the data does change, then 1 will 
make every effort to get a new data file 
out to replace the old one. 

The CON5T.DAT file holds the values 
lor the right ascension and declination 
of over 150 of the brightest stars, which 
are used by the Horizon Plot and Zenith 
Plot menu options. The format for this 
file is: right ascension (in hours), and 
declination (in degrees). 

The file S_RA.DAT is another se- 
quential file which contains only die 
right ascensions of over 1500 stars. The 
format for each entry is HHMM.M, 
which means that the first two charac- 
ters are hours, the next two are minutes 
and the final is a fraction of a minute. 
Thus, if an entry is 01588, the right 
ascension of that star is one hour, fifty- 
eight point eight minutes. 

The S_DE.DAT file, which contains 
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declinations, is set up much the same 
way. Each of the star entries have a for- 
mat of SDDMM, where S is the sign of 
the declination (either positive for north 
or negative for south), DD lor the 
degrees, and MM for the minutes of arc. 

Finally, the S_MAG.DAT file contains 
the magnitudes or brightnesses of each 
of the over 1500 stars. Each of the en- 
tries just consists of a number, positive 
or negative, corresponding to the magni- 
tude of that star The smaller the num- 
ber, the brighter the star. 

The HELEDOC file is simply an 
ASCII text file. 



Irlany 

people living 

in large cities have 

never really taken 

the time to appreciate 

the beauty of the 

night sky. 



AD ASTRA 

If the aSTronomer increases your inter- 
est in astronomy, just go to your nearest 
library and read up on mankind's ol- 
dest, and still perhaps most interesting, 
science I hope that amateur astron- 
omers will find the data generated by 
this program an excellent supplement to 
their studies, and that beginning as- 
tronomers, and people with no previ- 
ous interest in astronomy, will be able 
to pick up new information and gain an 
appreciation ol the starry heavens. ■ 
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S TPIus 

P.O. Box 1197, Berkeley, CA 94701 




Every day the ST becomes a stronger force in the world ol computers. Now is the time to 
pick up that extra ST you need to really get productive. Prices have never been lower and 
support from ST plus is the best you can get at any price. Tell your friends and get involved 

in the ST revolution! Desktop Publishing is finally AFFORDABLE for the best of us/ 
Hardware Specials:1/2 meg ST mono:$499, color $779, 1 meg ST 
mono$711, color $869; 2.5 meg ST mono $1050, color $1120, 3meg mono 
$1139, color $1299; 4 meg ST mono $1799, color $1959. QMS ps800 
Laser Printer$4449, HP 2 $2395, Canon 250k $1959,1. 25mb$2950 
Scanner for your dot matrix printer $59.95. Publishing Partner $104.95!! 



BUSINESS 

DBMAN $104.95 

EZ-CALC 48.95 

DAC-EASY ACT 52.00 
DAC PAYROLL 42.00 
ZOOMRACKS2104.3U 
EXPERT OPIN. 70.00 
SWIFTCALC 56.00 
DATAMANGR 56.00 
VIP GEM 175.00 

DOLLARSENSE 70.00 
DATATRIEVE 35.00 
ISGURSTOCK 140.00 
POWERPLAN 35.00 
K-SPREAD 59.50 
PROGRAMMING 
MEGAMAX'C 159.95 
MARK WMS.'C 125.95 
PROFORTRAN 104.95 
OSS PASCAL 56.00 
ASSEMPRO 42.00 
CMBRGE LISP 139.95 
K RESOURCE ED 42 
LATTICE C 104.95 
LOW BASIC 1.1 55.95 
GFAFASTBASIC 56.00 
FASTACCPAK 35.00 



GAMES 

WANDERER 3D 27.95 
FLIGHT SIMLTR 35.95 
STARGLIDER 32.50 
BALANCEPOWR 35.00 
CHESSMASTER32.50 
SILENT SERVICE 27.95 
PSION CHESS 42.00 
TIME BANDITS 27.95 
SHANGHAI 27.95 

MATCH POINT 27.95 
TASS TIMES 27.95 

MOSTINFOCOM 27.95 
PORTAL&GATO 27.95 
BASE&FOOTBAL27.95 

EDUCATIONAL 
MATHTALK 35.00 

KIDTALK 35.00 

ALGEBRA 1-5 14.00 
BIOLOGY 1-4 14.00 
CHEMISTRY 1-2 14.00 
GEOMETRY 1-2 14.00 
PHYSICS 1-2 14.00 
STATISTICS 1400 

TRIGONOMETRY 14.00 
DECIMAL DUNGN27.95 
DONALD DUCK 21.00 



WRITING 

WORDWRITER 56.00 
THUNDER 27.95 

K-WORD 52.50 

TEXT-PRO 35.00 
1ST WORD 14.00 
FINAL WORD 104.95 
FONTWRITER. 27.95 
MIGHTY-MAIL 35.00 
LABELMASTR 27.00 
REGENTWRD2 70.00 
1ST MAILER 21.00 
Power WriterMultl- 
Lingual Ma1h$24.00 
TELECOM PRG 

FLASH 27.95 

FOREM ST 48.95 
MICH BBS 2.0 56.00 
AVATEX $109-149 

BOOKS 
ABACUS(MOST)15.95 
SYBEX GEM 18.00 
SYBEX BASIC 15.95 
EXPLORING ST 15.95 
SAMS 520 ST 35.95 
ST COMPANION 16 
WORKING W/ST 16 



GRAPHICS 

PAINTPRO 42.00 

Library&5 fonts 22 
DEGAS 27.95 

GRA.ARTIST 139.95 
E-Z DRAW 2.0 49.95 
DRAFIX 1 175.00 

MAGICSAC4.0 110 
MAC ROM'S 50.00 
FIRST CADD 35.00 
PUB PARTNER 104.95 
NEOCHROME1. 27.95 
SART 26.50 

MAKE IT MOVE 35 
AEGIS ANIMATOR 56 

ACCESSORIES 
1040 COVERS $7.50 
520 COVERS 7.50 
PRINTERS 20.00 

SF314 5.354 7.50 

MONITOR COV. 12.50 
CABLES 20.00 

ATARI MODEM 80.00 
PAN lOBOi 239.00 

CITIZEN 35 LQ 525.00 
EPSON DX-10 239.00 
EXECUTIVE PAK 29 



STPIus continues its long distance retail with maximum support. When you support us you help the 
ST grow because we put all our resources into Atari accessories. Whatever you need for the ST you 
can bet we will have it. We will spearhead the ST Desktop Publishing Revolution into the '90s II 
CALIFORNIA (800)874-4789 WE SHIP ANYWHERE! 100% SERVICEI 
NATIONAL (800)433-6222 AMEX-VISA-MC-DISCOVER CODadd $5 
LOCAL (415)849-8717 3% credit card charge on Atari hardware only 
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A REVIEW 



THE ST DESKTOP PUBLISHING 
BOOM BEGINS 



SY CHARLES E. JOHNSON 



rhere are some programs that, in themselves, make it worth- 
while to purchase the computer they run on. Certainly, 
many people bought IBM PCs simply to run Lotus I -2-3 
or dBase. Publishing Partner is such a program lor the Atari 
ST; a program whose power and usefulness are limited only 
by the imagination of the person using it. li you think you 
sense a "rave review" coming, you're right-but my satisfac- 
tion with Publishing Partner is slightly clouded by a few bugs 
that persist through the latest version of the software. 

Desktop publishing is a rapidly growing new genre of soft- 
ware, allowing the design and production of professional- 
looking documents (with either a dot matrix printer or a laser 
printer) on a personal computer Programs such as Print Shop 
for the 8-bit Atari computer and Print Master for the ST are 
very simple examples of page design tools. With these pro- 
grams you can create greeting cards, banners, calendars, and 
the like. Publishing Partner offers an infinitely more elegant 
and open approach; with it you really can design almost any 
type of document you can imagine 

Publishing Partner is a full-featured desktop publishing 
program written entirely in 68000 assembly language. It's 
somewhat reminiscent of Aldus's PageMaker for the Macin- 
tosh. It works in either monochrome or medium-resolution 
color on the ST, but monochrome is preferable; in medium- 
res, text characters and graphic objects may appear somewhat 
distorted, though they look fine on the printer. 

With Publishing Partner, you work on full printer-page 



sized documents and can only see a portion of the page on 
screen at once, unless you choose the "View Full Page op- 
tion." It allows you to create columns and enter text into 
them, draw graphics, import pictures created with DEGAS or 
NEOchrome (it even handles the popular public domain 
TINY picture compression format), and much more. Partner 
reads picture files saved in any resolution and converts them 
to the resolution you're using. You can resize and crop any 
column, graphic object, or picture in any direction. When 
you enter text into columns, Partner functions as a word 
processor with justification, word-wrap, block move, delete 
and other standard features, and your text is constantly refor- 
matted as you type. Resizing a column with text in it will 
cause all the text to be quickly readjusted to the new column 
size. One more very nice feature: the program is not copy- 
protected and can be easily backed up and installed on a 
hard disk or a RAMdisk. 

When you load Publishing Partner, you'll see the screen 
shown in Figure I. The familiar GEM drop-down menus are 
there, along with a column of tools and other icons along the 
right side of the screen. The main screen displays the Upper 
left-hand corner of the document when first booted; there are 
GEM-like window sliders and scroll bars enabling you to 
move around in your document and view different sections. 

There are many ways to view your document: You can 
view multiple pages (two pages at a time-see Figure 2), show 
the full page, show actual size, 50% size, or 200% size. If this 
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isn't enough for you, you can set your own scale for viewing 
die document. An acronym you'll see a lot in articles about 
desktop publishing is WYSIWYG (enunciated "wizziwig"), 
which stands for "What You See Is What You Get" - and 
that deseribes the Partner approach exactly. At all times, you 
see a very close approximation of what your eventual printed 
copy will look like. In some sizes, text may not be readable 
and pictures may not look quite right (especially in the "View 
Full Page" mode), but they'll look correct when you print 
them. 

Publishing Partner has a dizzying array ol type styles (far 
more than GDOS currently allows) including backslant, bold, 
double-underline, italics, light, mirror, outline, reverse text, 
shadow, strike-through, tall, upside-down (?), and wide. 
Whew! Character size is referenced in terms of points, a 
typographer's term (a point is about 1/72 of an inch). You 
can adjust type sizes all the way from 3 to 72 points, and the 
program supports multiple type faces, but it is being shipped 
with only two at present (SoftLogik promises more on the 
way). All these text options are selected from customized, 
non-GEM dialog boxes, which allow more flexible input than 
the normal GEM routines. And all the text is fully propor- 
tional; the program will even let you adjust the spacing be- 
tween individual letters in a word, an option called "manual 
kerning" (another typographic term). 

To define a column in which you'll enter text, all you need 
to do is choose the arrow tool from the toolbox on the right, 

FIGURE 1. Start-up screen of Publishing Partner. 
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point at the starting place with the mouse, and drag an ex- 
panding box to the desired size. You can arrange columns so 
text will flow automatically from one column to the next; 
Partner calls this feature "text routing." By using text routing. 
it's easy to construct multi-page documents. You use the 
mouse to mark blocks of text and change typestyles, point 
sizes, justification, centering and other attributes. 

Unfortunately, the text routing portions of the program 
seem to be the most bug-ridden. Occasionally, when resizing 



text that extends through multiple columns, Publishing Part- 
ner will briefly show two or three bombs and then dump you 
buck to a frozen desktop. This problem is most likely to occur 
if you're changing text to a larger size. 

The program lets you draw designs directly on your docu- 
ment free-hand with the mouse, and also gives you a compre- 
hensive set of graphics drawing tools. You can draw lines, 
connected lines, vertical and horizontal lines, circles, boxes, 
boxes with rounded corners, and ellipses; and all these 
graphic objects can be filled with one of a number of pat- 
terns. Anything you draw will become a graphic object, and 
can be resized, cropped, and moved about at will. 

In addition to its own graphics features, it's a simple mat- 
ter to use pictures created with DEGAS or NEOchrome You 
simply enter "Picture" mode, and choose the Import option 
from the File drop-down. Your picture is copied into a work- 
screen, from which you can cut a block and place it in the 
"copy buffer." Then you just flip back to your document, and 
use the "Copy from Buffer" option to place the picture at the 
desired position. After you've placed the picture, you can 
manipulate it in the same way as any other graphic object. 
Resizing pictures may sometimes cause them to appear dis- 
torted on screen, but 1 found that even the most distorted pic- 
tures would usually look fine when printed. 

You're not limited to an 8Vi" by 11" page, either. Publishing 
Partner lets you custom-design any page size your printer can 
support, with settings measurable down to eighths of an inch. 
Once you've created a document, you can choose the "Show 
Rulers" option to display vertical and horizontal rulers for ex- 
tremely accurate placement of text and graphic objects (see 
Figure 3). Small indicators on the rulers show the exact posi- 
tion of the mouse pointer on the screen, to make this opera- 
tion even easier You can also set the rulers for inches, picas, 
or centimeters. 

Publishing Partner uses a proprietary method of handling 
text output to screen and printer. It does not use Atari's 
GDOS, contrary to early reports. The Partner method is actu- 
ally much more flexible than GDOS, giving you many more 
text styles and font point sizes. The program comes with 
drivers for many popular brands of printers, including a Post- 
script driver for the Apple LaserWriter or any printer capable 
of using the Postscript page description language. It also has 
drivers for most Epson-compatible 9-pin dot matrix printers, 
and drivers for the new 24-pin printers like the NEC P6. 

1! you're using a 9-pin dot matrix printer, be prepared to 
wait a long time for your hardcopy to be finished. Partner 
uses the quadruple-density graphics mode of these printers, 
and does lour passes ol the printhead to print each line. This 
results in unbelievably clear print quality, with none of the 
dots and jagged lines you may be used to seeing on your 
printer; but a typical time to print a one-page 8 1 /:" by 1 1" 
document is 20-30 minutes. The most recent version of the p> 
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Publishing Partner. 



program has improved the print speed somewhat by buffer- 
ing the picture data and tabbing past blank space, but this is 
more a limitation of dot matrix printers than of Publishing 
Partner's. 

By now you might be thinking you should go buy this pro- 
gram right away. I'm sorry to have to report that some bugs 
still remain in the program (as of version 1.01). I've managed 
to make the program crash all the way back to the desktop (a 
non-functioning desktop, at that) quite a few times-and not 
always in repeatable ways, either On the most recent occa- 
sion, all I was doing was typing text into a column. Another 
time I was resizing text in linked columns; the program 
worked fine for a few operations, then suddenly, bombs 
away! A rude interruption, to say the least. Another problem: 
sometimes deleting a column of text does not release the 
memory it used, and you end up with an "Out of Memory" 
error. At least this problem is non-fatal; you can just save the 
document, quit and restart the program, and the memory is 
back. 

I've learned to save documents very often when working 
with Publishing Parmer, because 1 just don't trust the program 
to run very long without crashing. This casts a definite pall 
over my enjoyment of Partner- it's just about the only nega- 
tive aspect of the program, but it's a large one! However, Soft- 
Logik is aware the bugs exist and is regularly releasing up- 
dates with fixes for the problems. 

1 have a few minor quibbles with Publishing Partner's user 
interface. Those custom dialog boxes that let you adjust char- 
acter and line spacing and manual kerning are very nice, but 
the response time is so fast that I found it almost impossible 
to change spacing by increments of one point. The value 
would always jump two or more, no matter how quickly 1 
pressed and released the mouse button. The way Partner han- 
dles the GEM file selector is also rather awkward -the box 
comes up without a drive specifier on the directory line, mak- 
ing it difficult (but certainly not impossible) to change disk 
drives. And there's no provision for grouping objects together: 



For example, say you create a column of text and then decide 
that a line would serve nicely to separate one section from 
another. There's no trouble with drawing the line where you 
want it, but if you decide later to move that text column, the 
line doesn't move with the rest of the column. You have to 
reposition it manually. 

Publishing Partner is one of the most impressive programs 
to appear for the Atari ST; indeed, it's one of the most impres- 
sive programs I've seen for any computer. (What makes it 
even more incredible in these days of programming teams is 
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FIGURE 3. "Show Rulers" with "Show Full Wio'K '. 

that the program is the work of one man, Deron Kazmaier.) 
SoftLoglk is very committed to supporting their product. 
They've released public domain screen font editors and 
printer fonts, which are available on many online services, 
such as CompuServe or Delphi. SoftLogik has shipped the 
first update (with some bug fixes) to registered owners, and 
Kazmaier is constantly updating Publishing Partner's printer 
drivers and adding new printers to his "supported" list. So, in 
spite of its current bugs, I highly recommend this program. ■ 
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VIP Professional 

The New Generation Spreadsheet 
Spreadsheet, Database, Graphics and Macros 
With Total Lotus 1-2-3™ Functionality 

VIP Professional Professional was modeled alter the powerful, best-selling Lotus 1-2-3. It not only has 
the same commands and features, you can also type the same keys to do the same things It can also read and 
write Lotus files and run all Lotus macros. So you have immediate access to thousands ot worksheet models, 
hundreds of macro applications, tens of books, scores of training courses, skads of user groups, and bulletin 
board services to help you make the most ot Professional, and share data with the rest of the business world. 

Mouse Interface You may elect to use the keyboard for all commands, but Professional also provides a 
full-featured mouse interface with Icons. Dialogue Boxes, Pull-down Menus, Mouse Ranging, and Scroll Bars. 
This makes command selection, movement in a sheet, range selection, splitscreen use and a score of other 
functions much more intuitive and easy to use. What were once complex commands with Lotus are now only a 
mouse-click away. 

1 . Spreadsheet Nothing is left out of this giant 256 column by 8192 row spreadsheet. You get 

variable column width, split screens, frozen titles, sorting, tile combine and extract, copy, move, range naming, 
local and global cell protection, total printer control, and over 50 special functions to make worksheet creation 
a snap. And Professional supports up to four megabytes of memory - when you need real power! 

2. Database Professional includes a powerful data manager to help you arrange, store and analyze 
information about your home or business It allows upto8192 records. with upto256fields. and has 
commands tor sorting, data queries and statistical analysis. 

3. Graphics With Professional's presentation graphics you can give shape to your figures with five 
different types ol graphs- pie chart, bar, stacked-bar, line and XY graphs. With the many options available you 
can decorate your graph just about any way you wish. You can also print presentation-quality graphs with 
different fonts, sizes - and colors too' 

Macros Professional features macros for automating repetitive tasks. Macros also allow you to program 
Professional for doing your accounting, inventory control, even school work. 

JuSt Minutes to Learn Professional comes with a user-sensitive handbook for the newcomer. And help 
is built right into the program With the handy tutorial you will be able to create your first worksheets in just 
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PLUMBING 
GEM'S 

MYSTERIES 

WRITING TO THE DESK 
ACCESSORY PIPELINE 



by To: 



Hudson 



u 



Incil recently, I've never had a 
lot of use for desk accesso- 
ries. Like most people, I saw 
them as little programs that allowed you 
to change the default screen colors, in- 
stall your printer, set the system clock or 
do other simple tasks. I usually didn't 
bother using accessories much, because 
they took up RAM that 1 needed for 
program development. Accessories such 
as Thunder!, irom Batteries Included, 
show that accessories can do much 
more than just sit there using memory. 
They can really perform a useful func- 
tion in conjunction with the primary 
application. 

While developing DEGAS Elite in the 
summer of 1986, 1 was perusing the 
GEM AES (Application Environment 
Services) manual and happened to no- 
tice several interesting-looking AES 
functions that I had never used before. 
in File DECOMM.ARC 
■ on your START disk 



^iipes — the final frontier. Contributing Editor Tom 
Hudson shows how you con get at GEM's internal 
communications plumbing without using a monkey 
wrench or calling Roto-Rooter. Tom's example pro- 
gram, a desk accessory for DEGAS Elite, is on your 
START disk. 



The first function, appl_find(), 
allows a GEM application (either the 
main application or a desk accessory) 
to locate another application or desk ac- 
cessory and obtain its ap_id, or "appli- 
cation identifier," a unique number that 
is assigned to each accessory or appli- 
cation currently in memory. "That's 
nice," I said skeptically, "but what good 
is that?" Then 1 read it: The application 
must know the ap_id before it can estab- 
lish cum muni cations with another applica- 
tionl What's this? You mean programs 
can talk to each other? 

My question was answered almost 
immediately, as 1 moved on to the other 
two communication functions, appl_ 



read( ) and appl_write( ). These two 
functions have proven to be a virtual 
goldmine, and in this article I will 
demonstrate how to use them to ex- 
pand your program functions without 
having to change the main program. 

THE PIPELINE 

At the core of the GEM program func- 
tions is a simple message system known 
as the message pipe. If you've ever writ- 
ten a GEM application, you'll be familiar 
with this system. By using the evnt_ 
mesag() or evnt_multi() functions, 
your program waits until GEM sends it 
a message telling it that the user has 
taken some action the program must re- ► 
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PLUMBING... 

spond to. GEM has a simple set of pre- 
defined messages for such functions as 
menu bar item selection, setting win- 
dow control points, moving or sizing 
windows, and so on. Each of these mes- 
sages is set to a standard length of 16 
bytes. 

The interesting thing is, your pro- 
grams can easily send messages to an- 
other application in the system, or even 
to itself, impersonating the GEM event 
manager! The standard message is 16 
bytes in length, but user-defined mes- 
sages can be larger, if desired. This proc- 
ess is actually quite simple, but there 
are a few guidelines that should be fol- 
lowed, and a few problems you should 
watch out for If properly done, commu- 
nication pipe inter-application commu- 
nications is a reliable way for programs 
to exchange information. 

LET'S GET TALKING! 

The standard GEM message is a 16-byte 
chunk of data, organized into eight 
words, as follows: 

WORD 0: Message number 
WORD 1; The ap_id of sending 

application 
WORD 2: Additional bytes in message 

(if more than 16 bytes) 
WORD 3: Message-specific 
WORD 4: Message-specific 
WORD 5: Message-specific 
WORD 6: Message- specific 
WORD 7: Message-specific 
Word number zero, the message num- 
ber, must be a unique value ranging 
from $0000 to $FFFF. Messages 0-41 
are used by GEM, so if you're going to 
define your own messages, be sure to 
use a number other than those reserved 
for GEM, or you might confuse the 
receiving application! 

Word 1 is the ID of the application 
that's sending the message. When send- 
ing messages, it is important to place 
the proper ap_id in this location. 
Without a proper ap_id here, the ap- 
plication that receives the message won't 
know where it came from, and if it tries 
to respond by sending a message back, 



GEM may get confused. The moral of 
the story: Always know your applica- 
tion's ap_id. Fortunately, you can al- 
ways find your program's ap_id in the 
global variable gl_apid. In C, you can 
define this variable as follows: 
extern hit gl_apid; 
When sending a message, just move 
gl_apid to word 1 of the message. 

Word 2 in the message is the extra 
number of bytes in the message. For a 
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standard 16-byte message, this value is 
set to 0. For a 20-byte message, the 
value here would be 4 (20-16). The 
minimum message size is 16 bytes. 

The remaining five words in the 
standard message are available for data. 
When designing messages for your pro- 
grams' use, you can fit up to five pieces 
of word-sized data in a standard mes- 
sage. If you need to pass more data, you 
can do so by specifying the extra num- 
ber of bytes in word 2, and sending the 
extra bytes through the pipe with the 
appl_write{) function. The receiving 
application can get the extra bytes from 
the pipe by using the appl_read() 
function. For extremely large blocks of 
data, pointers to the data may be passed 
in the standard message. 

Now that we know what the message 



format looks like, let's see what is neces- 
sary to send it. 

ADDRESS UNKNOWN? 

In order to send a message to another 
application or accessory, it is vital that 
you know the ap_id of that program. 
Without the proper ap_id of the 
receiving application, it's like dropping 
a letter into a mailbox without the name 
or address of the person you're sending 
it to. It just wont get there. 

The AES function appl_find{) will 
allow you to locate the application you 
would like to communicate with, and 
will give you the proper ap_id. The for- 
mat of the function is: 
target_id=appl_find("APPLNAME"); 
"APPLNAME" is a null- terminated string 
specifying the filename ol the applica- 
tion you want to find and target_id is 
the variable that holds the target appli- 
cation's ap_id. The program name 
string is eight characters in length plus 
the terminating null character (0), and 
is simply the main portion of the appli- 
cation's filename. If you were looking for 
a program called RATTFINK.PRG, you 
would use:" appLfrndC'RATTFINK"). 
Similarly, if you're looking for CLOCK- 
5ET.ACC, you would request: appl_ 
findC'CLOCKSET"). If the filename is 
less than eight characters, such as 
SHORT.PRG, you must pad the re- 
mainder with spaces: 

target_id=appI_findC'SHORT "); 
The ap_id of the target application will 
be returned in target_id. If the 
specified application name was not 
found, GEM will return a -1 in target_ 
id. One word of special caution here: If 
the target application is a program and 
was the last program that was executed, 
a bug in the current ST ROMs will re- 
turn a seemingly valid target_id, while 
the application is not resident at all! If 
the program (usually an accessory) tries 
to communicate with the target applica- 
tion and expects a reply, it will have a 
long time to wait, because the applica- 
tion isn't there! We'll see how to cope 
with this later 
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Once you know the ap_id of the 
target application, you're ready to start 
talking to it- Simply build a message in 
an eight-word array, like so; 

message[0l=0x4000; 

message! 1 1 =gl apid; 

messageI2]=0; 

messagel31 = 1234; 

message(4]=0; 

message(51 = 0; 

message(61=0; 

message!7l = 0; 
In this example message, we're sending a 
message number of $4000 (safe because 
GEM only uses message numbers 0-41). 
We have placed the ap_id of our appli- 
cation (gl_apid) in message! II. The 
message is 16 bytes long, the standard 
length. Note that messaged! is set to 
zero, indicating that there are no extra 
message bytes. The message in this case 
is a simple numeric value, 1234, in 
messageBI. 

Okay, we've built our message 
buffer, now let's send it. For 
this function, we'll use the 
appl_write() function. This function 
has three parameters, as shown below; 
success = appl_write(target_id, 

msg size,msg_buff) ; 

The target_id parameter is a word that 
tells GEM the ap_id of the application 
we want to send the message to. The 
msg_size parameter is a word that tells 
how many bytes there are in the mes- 
sage, and msg_buff is a pointer to the 
message buffer array. The success vari- 
able is set to zero if an error occurred, 
or a positive value if the write was suc- 
cessful. Let's say we want to send the 
above message to a desk accessory 
called TESTER.ACC. The following code 
would get the job done: 

target_id=appl_nnd("TESTER "); 

if(target_id> = 0) 

success = appl_write(target_id, 



16,message); 

Simple enough?- Sure. However, we still 
don't know how to make the . 



TESTER.ACC program look for and ac- 
knowledge this message. 

THE RECEIVING END 

Normally, a typical GEM application or 
desk accessor)' will sit around waiting 
for a message to come into its message 
pipe. This is accomplished by using the 
evnt_mesag() or evnt_multi() func- 
tions. For simplicity we'll use the 
evnt_mesag function, which is the 
more straightiorward of the two. 

Somewhere in our TESTER.ACC pro- 
gram, there will be an evnt_mesag() 
function call, looking something like 
this: 

evnt_mesag(mess_in); 
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Usually, an inactive accessor)' will only 
receive one of two messages from the 
GEM event manager: 40 (AC_OPEN) or 
41 (AC_CLOSE). We can make it 
recognize our custom message merely 
by testing the message number of the 
incoming message for our special code! 
For example, to have the accessory look 
for the $4000 message we sent earlier, 
this is the code we would need: 

int mess_in!8l; 



evnt_mesag(mess_in); 

if(mess_in[01 = =0x4000) 

[ 

(WE GOT THE MESSAGE!) 

(PRINT OUT mess_inl3)) 

J 



It's that simple! No muss, no fuss. The 
16-byte message buffer (mess_in) will 
be filled with the 16-byte message that 
was sent by the other application, and 
it's ready to be used by the accessory. 

TWO-WAY MESSAGES 

In many cases, you'll want to have one 
application send a message to another 
application, requesting specific infor- 
mation. For example, a desk accessory 
may need to know the address of a data 
buffer within an application. This type 
of message requires two-way communi- 
cation, which is a little more tricky. 

When I design a two-way message, I 
usually set it up so that message num- 
bers with a low byte of $00-7F are re- 
quests, and message numbers with a 
low byte of $80-FF are replies. For ex- 
ample, a request for information might 
be message number $4000, and the re- 
ply for this message is $4080. The reply 
is always the message number with $80 
added to it. This makes for a uniform 
message system, and prevents a pro- 
gram from being confused by a different 
message. 

Let's change our above example so 
that the application is requesting infor- 
mation from the accessor)'. The applica- 
tion will send a message to the acces- 
sory, which will in turn send a reply 
back to the application program. The 
application program, after sending the 
message to the accessory, will wait for a 
reply from the accessory before 
proceeding. 

The application code might look 
like; 

/* SEND MESSAGE TO ACCESSORY */ 
target_id = appl_find("TESTER "); 
if(target_id>=0) 
{ 

message(01 = 0x4000; 
messagel 1 1 =gl_apid; 
message[21 = 0; 
messagei31 = l; 

messagel41 = messagel5] = messagel6l 
= message!71 = 0; 

appl_write( targe c id, 16, message); 

/* WAIT FOR REPLY */ ► 
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do 

( 

evnt_mesag(message); 



while messagelOl != 0x4080; 

J 

/* REPLY RECEIVED, CONTINUE 

PROCESSING */ 

As you can see, the applica- 
tion writes the message nor- 
mally, then goes into a loop 
that waits for an evnt_mesag with a 
message number of $4080, the reply to 
message number $4000. As long as the 
target accessory is in memory, every- 
thing should work perfectly. If messages 
other than number S4080 are received 
by the application, it ignores them and 
continues waiting. (Note: It may be 
necessary, in certain rare instances, to 
process other messages received by this 
loop, such as redraw messages. This is 
usually not the case.) 

The accessory code that would proc- 
ess this message is as follows: 

int mess_ouri81; 



/* WAIT FOR MESSAGE FROM THE 

PIPE */ 

msg_wait: 

evnt_mesag(mess_in); 

if(mess_in(01 = = 0x4000) 

( 

mess_oud0l = 0x4080; 

mess_outl 1 1 =gl_apid; 

mess_outl2]=0; 

mess_out(3l = l; 

mess_out!41=2; 

mess_oud51 = 3; 

mess_outl61=4; 

mess_out!7) = 5; 

appl_write(mess_in[ 1 l,16,mess_out); 

] 

goto msg_wait; 

When the accessory code receives mes- 
sage number $4000, it just builds a re- 
ply message with the proper reply mes- 



sage number ($4080), places its ap_id 
in mess_outUl, and builds the rest of 
the message accordingly. It then writes 
the message to the message pipe using 
the appl_write() function. Note that it 
used the value that it received in 
mess_inill as the ap_id of the appli- 
cation that it is sending to. This is ex- 
tremely important! If the original sender 
does not supply the proper ap_id in its 
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message, the receiving applica- 
tion/accessory cannot successlully re- 
ply. Don't forget to place the gl_apid 
into the second word of the message 
buffer! 

To summarize this sequence of com- 
munications operations: 

1. Program #1 gets the ID of the pro- 
gram it wants to communicate with; 

2. Program Wl builds and sends the 
message; 

3. Program #1 enters evnt_mesag( ) 
wait; 

4. Program #2 receives the message; 

5. Program #2 composes reply message, 
sends to original sender; 

6. Program #2 returns to message wait 
state; 

7. Program #1 receives reply from pro- 
gram #2, continues processing. 

This is a fascinating process, and can be 
extremely useful. We'll see a real-world 



application ol the technique in a mo- 
ment. In my latest application of the 
communication pipe, CAD-3D 2.0, the 
main program uses desk accessories to 
perform optional peripheral operations, 
such as animation scripting, animation 
recording, and graphics antialiasing 
(smoothing of jagged lines). Each of 
these accessories is independent, and in 
some cases the communication path 
can become quite complicated, with 
processing often passing from accessory 
to the main program to a second acces- 
sory and back! To actually watch it hap- 
pen is amazing. 

To me, though, the real power 
lies in being able to build more 
complex programs out of 
smaller pieces, or modules. These mod- 
ules can be designed to be periodically 
upgraded to newer versions that do a 
more efficient job, without having to 
change the main application. Further, an 
extensive communication protocol can 
be built into the main program, allow- 
ing it to be controlled remotely by a 
desk accessory. This possibility be- 
comes more practical as newer ST com- 
puters, with more memory, are in- 
troduced. Theoretically, a desk 
accessory could be as large or larger 
than the original program, and they 
could work together to perform more 
advanced functions. 

SOME WORDS 
OF CAUTION 

The successful use of the communica- 
tion pipe with customized messages de- 
pends on a well-defined communica- 
tion protocol If possible, send the 
entire message in the standard message 
length of 16 bytes. Use pointers if you're 
sending large blocks of data. If your ap- 
plication will be sending a large number 
of messages quickly, one right alter an- 
other, use the two-way request/reply 
system shown above to avoid overflow- 
ing the pipe. The receiving application 
may have to do a bit of processing lor 
each message-play it safe. 
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As 1 mentioned earlier, it is possible 
for a desk accessory to request the ap_ 
id of an application and get a valid id, 
even though the application has termi- 
nated. If this happens, the accessory 
may send a message to the application 
and sit there forever, awaiting a reply 
that will never come. You don't want 
that to happen (take it from someone 
who knows from experience). Here's a 
good solution to this dilemma. 

Send an information request to the 
application (one that requests informa- 
tion only and does not command the 
application to take action) and then call 
the evnt_multi() function waiting for 
either a message or a timer event. Set 
the timer length to 2000 milliseconds. Ii 
you get the reply from the application 
before the timer event occurs, the appli- 
cation is really present and you can 
proceed. Do this every time the acces- 
sory is activated from the desktop DESK 
dropdown. It is not necessary if the ap- 
plication has called the accessory. This 
evnt_multi may look something like 
this: 

check_it: 

event =evm_multi(0x0030,- 1,-1,-1, 

0,0,0,0,0, 

0,0,0,0,0, 

mgbuf, 

2000,0, 

&dum,&dum,&dum, 

&dum,&dum,&dum); 
if(cvent& 0x0020) 
(APPLICATION NOT PRESENT) 
else 

if(mgbufI0l= = REPLY) 
(APPLICATION PRESENT) 
else 
goto check_it; 

This is a reliable test to be sure 
the application is really there. If 
the application was previously 
run but is not currently running, the 
timer event of 2000 milliseconds (2 se- 
conds) will expire before a reply mes- 
sage is received. 



REAL WORLD EXAMPLES 

The file DECOMM.C on your START 
disk is a real-world example of the com- 
munication pipe. This is the source 
code for a desk accessory that "talks" to 
DEGAS Elite and gets information on 
the screen being used, the screen buffer 
locations, block size and more. If you've 
seen the TINYLOAD.ACC accessory for 
DEGAS Elite, you've seen another exam- 
ple of the technique in use. This is a 
very practical use o! the communication 
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pipe. The DEGAS Elite program was get- 
ting so large that it barely fit into 512K 
systems, so 1 decided to make the pro- 
gram expandable through desk accesso- 
ries. The accessories can ask Elite 
where its screens are and which screen 
is in use, then load data into the screens 
and change the palette. Let's see how it 
works. 

DEGAS Elite supports five communi- 
cation pipe commands, numbered 
SDE00 (DE-Degas Elite-get it?) 
through SDE04. These commands are 
listed below. 

Screen Buffers. 
SDE0O- Request screen addresses. This 
command simply asks DEGAS Elite to 
tell the accessory where the screen 




buffers are located. The message is for- 
matted as follows: 

messagelOl = $DE00 

messagelll = Accessory ap_id 

messaged! = 

message!3I = Unused 

messageHI = Unused 

message!51 = Unused 

messagel61 = Unused 

message!71 = Unused 

EGAS Elite will respond 
'with message SDE80, the 
reply for $DE00. This mes- 
sage is formatted as follows: 
messagelOl = SDL80 
messagelll = DEGAS Elite ap__id 
message!2l = 

messagel31 = Low word of pointer 
to screen buffer 
pointer array 
messageHI = High word of pointer 
to screen buffer 
pointer array 
messagel51 = Number of pointers 

in array 
message(6l = Unused 
messagel71 = Unused 
This reply message is fairly straightfor- 
ward. Message words 3 and 4, when 
put together, form a pointer to an array 
of pointers that point to the various 
screen buffers within DEGAS Elite. Mes- 
sage word 5 tells how many pointers are 
contained in the array. The array cur- 
rently contains 13 pointers, allocated as 
follows: 

arraylOl = Pointer to main menu 

screen (don't alter!) 
array! 11 = Pointer to drawing screen 

#1 
array!2) = Pointer to drawing screen 

#2 
array[3l = Pointer to block buffer 
array! 41 = Pointer to Block mask 

buffet 
arrayl5l = Pointer to Block work 

buffer 
array!61 = Pointer to Undo buffer 
arrayl71 = Pointer to drawing screen 
#3 (0 if not present) ► 



STart, The ST Quarterly 



47 



PLUMBING... 

arrayE81 = Pointer to drawing screen 
#4 (0 if not present) 

array[9l = Pointer to drawing screen 
#5 (0 if not present) 

arraytlOl = Pointer to drawing screen 
#6 (0 if not present) 

array! Ill = Pointer to drawing screen 
#7 (0 if not present) 

arrayll2l = Pointer to drawing screen 
#8 (0 if not present) 
Future versions of DEGAS Elite may 
support more than 8 drawing screens, 
so be sure to look at messaged] for the 
number of pointers. As noted above, if 
the screen pointer is zero, the screen 
buffer was not allocated. Do not use 
these buffers. Two buffers may be used 
by the accessory for "scratch" buffers. 
These are arrayi53 and arrayl6L The ar- 
ray!51 buffer is a temporary work area 
used when drawing with a block image, 
and the array!6i buffer is the Buffer 
used to hold the image temporarily for 
the Undo key. These are discarded 
when you return to the menu screen, 
and so are available for use by your ac- 
cessory. Note that they may not be 
aligned for proper display use-use 
them only for data buffers or work areas, 
not display screens. 

If you want to check to see if 
DEGAS Elite is really there (to cir- 
cumvent the appl_find GEM 
bug), $DE0O is a good message to use, 
as the reply is sent back immediately. 

Current Screen 
Since DEGAS Elite has up to eight 
drawing screens available, your acces- 
sory may need to know which one is 
currently in use by the user The next 
command, $DE01, will request the 
screen number. This message is format- 
ted as follows: 

messaged! = SDE01 

messagell) = Accessory ap_id 

messaged! = 

message[3l = Unused 

messageKl = Unused 

messaged! = Unused 

messagel6l = Unused 

messaged I = Unused 



DEGAS Elite will respond with message 
number $DE81, formatted as follows: 

messagelOl = SDE81 

messaged] = DEGAS Elite ap_id 

messagelz] = 

messaged! = Screen buffer index 

message[43 = Unused 

messaget5I = Unused 

messagelfi] = Unused 

messaged] = Unused 
The screen buffer index is an index into 
the screen buffer array. If the index is 1, 
drawing screen #1 is in use. If the index 
is 11, drawing screen 7 is in use. Be sure 
to request the buffer addresses with the 
$DE00 command before using the 
SDE01 command so you'll be sure to 
have the buffer addresses handy. 

Get Block Parameters 
This command allows you to find out 
where the current "block" image is 
stored, as well as how large it is. The 
block parameter request message is for- 
matted as follows: 

messagelOl = $DE02 

messagell] = Accessor)' ap__id 

messaged! = 

messagei3! = Unused 

messageKl = Unused 

messaged] = Unused 

messagei6l = Unused 

messagei71 = Unused 
When DEGAS Elite receives this mes- 
sage, it will compose and send a reply 
message, $DE82, as follows: 

messagelOl = $DE82 

messagell I = DEGAS Elite ap_id 

messaged! = 

messagel3l = Index of buffer where 
block is located 

messageKl = X coordinate of upper- 
left comer of block 

messaged] = Y coordinate of upper- 
left corner of block 

messaged! = Width of block in 
pixels 

message!?] - Height of block in 
pixels 
In the current version of DEGAS Elite, 
the block is stored in buffer number 3, 
and always has its upper left comer at 
coordinates 0,0. This may change in fu- 



ture versions. If you choose to change 
the block, be sure you align it at the 
proper position in the correct buffer. 
Set Block Parameters 

DEGAS Elite allows accessories to 
change the current block size This 
would be necessary if the accessory 
loaded a different-sized block image 
into the block buffer. The command to 
change the block size is as follows: 

messagelOl = SDE03 

messagell I = Accessory ap_id 

messagel2l = 

message!31 = New block width 

messageKl — New block height 

message!51 = Unused 

messagel6l = Unused 

message[7l = Unused 

There is no reply to this message 
from DEGAS Elite However, it 
is important that you set the 
block size to a setting compatible with 
the current screen resolution (greater 
than and less than or equal to the 
screen width and height). 

Changing the Color Palette. 
If you are writing an accessory that 
loads a picture from disk and places it 
in one of the display buffers, you'll want 
to be able to set the color palette to the 
appropriate settings. This is done with 
the color palette change command, 
$DE04. This is a special case message, 
consisting of 48 bytes. It is formatted as 
follows: 

messagelOl = JDE04 
messagell] = Accessory ap_id 
message!2l = 32 

message!3l = Image palette set flag 
messageKl = Unused 
message[5I = Unused 
messaged! = Unused 
messaged] = Unused 
messagelBI = Palette color 
messaged] = Palette color 1 
messagell 01 = Palette color 2 
messagell II = Palette color 3 
messagell 21 = Palette color 4 
messagell3] = Palette color 5 
message!14] = Palette color 6 
message! 151 = Palette color 7 
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message(16l = Palette color 8 
message! 171 = Palette color 9 
message! 181 = Palette color 10 
message! 191 = Palette color 11 
messagel201 = Palette color 12 
messagcl211 = Palette color 13 
message(221 = Palette color 14 
message! 23) = Palette color 15 
The first 8 words in the message is a 
standard -length GEM message. Note 
that word 2 of the message is 32, in- 
dicating that there are 32 bytes (16 
words) of data following the main mes- 
sage. Word 3 of the message is a flag 
that tells DEGAS Elite whether or not it 
is to assign the palette to the currently 
selected drawing screen. If the word is 
0, the palette is loaded but is not as- 
signed to the current drawing screen. If 
the word is nonzero, the palette is 
loaded and is assigned to the current 
drawing screen. 

If you are loading a picture with a 
new palette, you will want to use a non- 
zero value in the flag, so that the picture 
will have [he proper colors assigned to 
it. If you're just changing the colors, use 
a zero in the flag. This will allow you to 
use the "remap" function to recolor the 
current picture to the closest match us- 
ing the new palette. 

When you send the color palette set 
command to DEGAS Elite, be sure to 
send a total of 48 bytes to Elite, with ei- 
ther a single, large message buffer (one 
appl_write) or with a normal message 
buffer and the palette array. Both op- 
tions are shown below. 
One large array: 

appl_write(DEGAS_id,48,messagc); 
Normal message buffer and palette 
array: 

appl_wTite(DEGAS_id,16,message); 
appl_write(DEGAS_id,32, palette); 
Either way, the 48-byte message will be 
received properly by DEGAS Elite. You 
must always send the entire 16-word 
patette array, regardless of the reso- 
lution. 



CAUTIONS 

When a program such as DEGAS Elite 
uses a communication pipe, you should 
use only the documented message pipe 
commands to get information from the 
program. Using tricks such as disassem- 
bling the program and locating un- 
documented variables or buffers is a big 
no-no, and can only lead to disaster in 
the future when a new version of the 
program is released. Don't do it. 'Nuff 
said. 

When an accessory takes 
over and must display 
a dialog, it is best for 
the accessory to open a full-screen win- 
dow over DEGAS Elite's control panel. If 
this is not done, mouse clicks on the 
panel will be relayed by GEM to 
DEGAS, possibly messing up the dis- 
play. Just be sure to close the window 
when your accessory is done with its 
work. When control returns to DEGAS 
(or whatever program you are working 
with), it will receive a full-screen redraw 
message, and will redraw its windows, 
control panels, and so on. 

DEMONSTRATIONS 

The DECOMM.ACC desk accessory 
program on your START disk is a 
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demonstration of how ro communicate 
with DEGAS Elite. It shows the use of all 
communication pipe commands and 
reception of replies from DEGAS. When 
activated, if DEGAS Elite is resident, the 
accessory will print out a report on 
your printer telling the status of Elite. It 
will print a list of pointers to the screen 
buffers, the current screen in use, and 
the block parameters. 

You can write all sorts of interesting 
accessories that will work with DEGAS 
Elite, and Patrick Bass, START Technical 
Editor has done just that. Check out his 
accompanying article for more informa- 
tion and ideas. 

With the communication pipe and a 
well-defined, well-thought-out commu- 
nication protocol, your programs can be 
written so that they can be easily ex- 
panded in the future It just takes a little 
effort when you're coding the main pro- 
gram. I hope you find this application 
for desk accessories to be as powertul as 
I have. 

Desk accessories. They're not just 
RAM-wasters any more. ■ 

IF YOU'D LIKE TO SEE MORE ARTI- 
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Capture Color Video Images: only $249. 



Now you can easily and inexpensively acquire images 

from any standard video source - videotape, camera, disk - 

tor display on your ST. Capture time is less than six seconds, 

and you have complete control of displayed color levels 

(or gray scales in monochrome). 

CompuierEyes has everything you need: 

Interface hardware, complete easy-to-use software support 

on disk, and owner's manual. It fully supports all 

ST graphics modes and a variety o! image formats and 

is compatible with virtually all popular graphics programs. 

Think of the possibilities! 

ComputerEyes is backed by a one year warranty and the 

success of over 10,000 systems sold. Satisfaction 

guaranteed or return it within ten days for full refund. 

Demo disk available, $3. See your dealer or order direct. 

For more information call 617-329-5400. >V^ 



To order call BOO- 346- 00 90 

o'mail your orders D:gi!al Vision, Inc. 

66 L=s:err- Avenue. Dednam, MA 03026 

VISA, MIC, or COD accepted 

S&H:$4 (or ComputerEyes. 

Mass. residents 
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DF 1000 $249 ESS 

• SINGLE DISK DRIVE 

• DOUBLE SIDED 
.UP TO 84 TRACKS 

. INTERNAL POWER SUPPLY 
. 2" Hx 4-1/4" Wx 9-1/2" D 



2 MEG MEMORY BOARD $495 ,«, 

4 MEG MEMORY BOARD $895 '"" 
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90 DAY WARRANTY 
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@ Hybrid Arts, Inc. 

Proudly Presents: 
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Kitt 
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$39.95 
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musical ST 



Consumer MIDI software 
tools and toys 



!Y JIM PIERSON-PERRY 



Okay -so you know the difference between a sequencer and 
a natch editor, and your ST is ready and waiting. Now 
you're ready to become the new Vangelis. But before you 
plunk down your money, breeze through this article, and 
let Jim Pierson-Perry show you what what's hot and what's 
not in the world of consumer ST music software. 



I M #elcome to the Atari ST MIDI software explosion! With its 16-bit architecture 
|#l# L,nL ' built-in MIDI pons, and a price roughly equivalent to a similarly 
' ■ configured Commodore 128, it's no wonder industry experts view the ST as 
the new "musicians' computer." There are now MIDI programs available for a variety of 
uses ranging from a player-piano simulation (based on real piano rolls) to a professional 
60-track sequencer system. 

If you're new to the electronic music world, it can be a bewildering experience to fight 
through the jungle of new terminology just to find out what these new programs are sup- 
posed to do -let alone try to use them. In this article, we will first look at the main classes 
of MIDI-based software and describe the functions and features you should look for. Then 
we'll examine commercial ST MIDI software products and see how they compare for fea- 
tures and performance. ► 
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Musical ST. . . 

Although we'll be looking at software for home and hob- 
byist use, many of the products are equally suited for the 
professional musician. (Editor's note; A separate article on 
professional MIDI software will appear in an upcoming issue of 
START.) To use most of these products, you need only your ST 
and a MIDI-compatible synthesizer such as the popular Casio 
CZ-101, Yamaha DX-7 or Ensoniq ESQ-1. Of course, the more 
MIDI equipment you have (like samplers, drum boxes, and 
expanders) the more involved your music can be-and the 
more you'll appreciate having the ST to hold it all together! 

INTRADA 

MIDI software comes in six types: music players, sequencers, 
scoring programs, patch editors, librarians, and utilities. 
Within each type are varying levels of features, and there is a 
fair degree of overlap between the types. 

As I write this, there are no stand-alone consumer- level 
music scoring or utility programs for the ST (although by the 
time you receive this issue of START, some commercial pack- 
ages should be in release). The programs covered here fit into 
the player, sequencer, and librarian, classes. An overview of 
the patch editors available for the ST will appear in an up- 
coming issue of START In this article I have a mini-review of 
each program and then highlight some of their specific fea- 
tures in the summary charts. 

The computer music/synthesizer field has its own arcane 
jargon, which may be daunting to the uninitiated. (For a good 
introduction to some of these terms, read "The Ins, Outs and 
Thrus of MIDI" by Tom Jeffries in START #4.) For the software 
in this review, it's important that you understand the terms 
red-time, step-time and patches. Music software with real-time 
functions records and/or plays your music at its normal 
tempo. In this sense, it serves as a tape recorder. With step- 
time, on the other hand, you can enter or play one step (note, 
beat, etc.) at a time. Many musicians use step-time to enter 
notes from sheet music or to get through complicated pas- 
sages that would be difficult to play in real time. A patch is 
the collection of settings or parameters needed to create a 
particular sound on a synthesizer 

MUSIC PLAYER PROGRAMS 

At the simplest level, a player program takes a data file con- 
taining musical information in the MIDI format and uses it to 
reproduce the original music on a MIDI instrument (typically 
a synthesizer). This is the digital equivalent of a jukebox. At 
higher levels comes the ability to enter musical data in step- 
time format along with non-music control events, such as 
changing the synthesizer voice or adding portamento, sustain, 
and vibrato. Some of these programs offer song playback 
through the ST's internal monitor speaker as well as external 
MIDI instruments. For a player program, availability of pre- 
recorded music on ST disks or as BBS files is important un- 





KEY TO CHARTS 


AT 


- aftertouch 


M = merge tracks 


C 


= copy 


ME = measure counter 


cc 


- MIDI controller 


MK = MIDI keyboard 


CD 


=s change drive 


N = note 


CK 


= ST keyboard 


PC = program change 


CP 


= cut and paste 


features only 


CZa 


- CZ-101/100075000 


R = rename file 


CZb 


= CZ-1/CZ-230S 


RW - rewind 


D 


- delete file 


S = segment 


E 


= event 


SW = swap 


F 


- format disk 


T = track 


FF 


= fost forward 


TM - tempo 


ID 


= insert/delete 


V = velocity 



less you only want to encode your own music. 

MIDI Magic ($39.95, Micro-W Distributing, Inc.) is an ex- 
ample of a simple player program. It relies on pre-recorded 
music disks (6 songs per disk at $19.95) as the music source. 
It has no provision for you to create your own song hies, but 
there are currently more than 100 music disks available. (In- 
terestingly, the music files are digital encodings of piano rolls, 
in some cases originally cut by Scott Joplin, George Gershwin 
and Liberace.) Playback is restricted to one MIDI channel. Al- 
though MIDI Magic may sound up to 12 notes at once, even a 
Casio with eight-voice capability will give you good results. 
This was one of the first MIDI programs for the ST, and more 
recent software has much better performance. Given its 
limited capabilities, the program is too costly to recommend 
unless you are specifically interested in its music library. 

The ST Music Box ($49.95, XLEnt Software) is a step up 
the performance ladder, with many new features including 
user entry of music and MIDI control data in step-time, score 
printout, and playback via MIDI or the monitor speaker You 
must buy the disk version specific to your monitor (color or 
monochrome). With this program, you can enter music with 
up to eight voices over four MIDI channels, and change tempo 
or MIDI instrument voicings with each measure! it also has a 
smart note entry editor to improve the accuracy ol song entry. 
You can use most control features via the function keys, al- 
though with no on-screen guide you must refer to the manual 
constantly. I found that the program has problems with error 
trapping and an annoyingly long response time going from 
the function keys to the main entry screen. Score printout is 
provided via a separate program, but is not of much practical 
use You can either have a normal score for only a single voice 
or print all voices but only one measure per line. On the 
bright side, the authors of ST Music Box also wrote the book 
Introduction To MIDI Programming ($19.95, Abacus), which in- 
cludes much source code and background for you to study. 

At the top of the player software ranks is The Music Studio 
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($59.95, Activision). This is a very well-designed program 
with numerous features, including step-time song entry, four 
independent music tracks (each containing up to 15 different 
MIDI voicings), and complete score printout. Playback can be 
through MIDI and/or a programmable internal synthesizer 
that plays in three voices through the monitor speaker (you 
must have a color monitor to run the program). The MIDI 
voicing features are specifically designed for Casio syn- 
thesizers, but other brands work just as well. The pop-out 
menus use the mouse and are fairly self-explanatory. Over 
one hundred song daw hies are available through bulletin 
board systems. This program has been enthusiastically 
received by users and I can strongly recommend it. 

The MIDlplay program ($49.95, Electronic Music Publish- 
ing House) straddles the player/sequencer boundary, and I've 
included it in the comparison charts for both. As a player 
program, it works with pre-recorded music disks (12 songs 
per disk at $19.95 each); 3 disks are now available, and 50 
more should be released during 1987. MIDlplay can also rec- 
ord real-time MIDI input from 16 channels into one track. 
Unfortunately, it has no music editing functions. Playback can 
be through MIDI or a programmable internal synthesizer that 
plays through the monitor speaker A nice addition is avail- 
ability of instructions though the HELP button. While the 
program works well as specified, there are several public do- 
main programs that are just as good for real-time recording. 
As a playback program alone, 1 find the price too high. It also 
needs some work on its mouse functions, which are occa- 
sionally unreliable. 

SEQUENCER PROGRAMS 

Sequencer programs are the next step beyond player pro- 
grams. The simplest sequencers record real-time input of 
MIDI music and controller data; more complex versions allow 
for sophisticated editing and manipulation of the music and 
can hold up to 60 independent tracks. A sequencer is like a 
multi-track tape recorder and, in fact, most such programs 
use a tape recorder metaphor in the user interface. 

A good sequencer program lets you edit music data much 
the same as you would edit text with a word processor, in- 
serting or deleting passages and cutting and pasting repeated 
sections. A MIDI thru feature is important too, especially if 
you are using a remote master keyboard controller. You also 
need external synching if the song tempo is to be controlled 
by a drum machine. Depending on the MIDI controtters used, 
some instruments may send too much information and clog 
the data stream. Data filtering can selectively remove un- 
wanted data and eliminate this problem. Other useful features 
are time correction (to synch the real-time notes played with 
the desired time signature), monitor metronome to keep 
steady time while playing, and punch in/out to overdub and 
correct bad notes. ► 



PLAYER COMPARISON CHART 



GENERAL FEATURES 








Version reviewed 


1.1 


— 


v425 


— 


Cost 


S49.95 


$59.95 


$49.95 


$49.95 


# tracks 


8 


4 


1 


1 


# simultaneous voices 


8 


15 


16 


16 


NeedTOSin ROM 


yes 


no 


no 


no 


Copy protected 


no 


yes 


yes 


no 


Input sources 


CK 


CK.MK 

low 


MK.PD 


MK.PD 


Monitor resolution 
SET-UP 


med/high 


med/high 


low 


MIDI/monitor output 


yes/yes 


yes/yes 


yes/yes 


yes/no 


Assign MIDI voicings 


yes 


yes 


no 


no 


Assign MIDI effects 


some 


no 


no 


no 


Programmable int synth 


no 


yes 


yes 


no 


Free memory indicator 


yes 


yes 


no 


NA 


DATA INPUT 


Real time data recorded 


no 


no 


oil 


NA 


Step time data recorded 


N,PC,TM 


N 


no 


NA 


#time signatures 


4 


8 


NA 


NA 


Smart measure entry 


yes 


no 


NA 


NA 


MIDI note range 


24-83 


0-120 


0-127 


0-127 


Note timing resolution 
EDITING FUNCTIONS 


1/32 


1/32 


NA 


NA 


File edit options 


no 


F,D,R 


no 


no 


Segment edit options 


CP,I,D 


CPJ.D 


CP 


NA 


Transpose/octave range 


yes/2 


yes/5 


yes/1 


no 


Duration scaling 


no 


yes 


no 


NA 


Add lyrics/song title 


no/no 


yes/yes 


no 


NA 


PLAYBACK 


Vary tempo 


yes 


yes 


yes 


yes 


Set cue point 


yes 


yes 


yes 


no 


Play selected tracks 


yes 


yes 


NA 


NA 


Medley ploy 


no 


no 


yes 


yes 


Music disks cost 


NA 


NA 


$19.95 


$19.95 


BBS song files 
SCORING 


few 


many 


NA 


NA 


Single voice score 


yes 


yes 


no 


no 


Sheet music score 


limited 


yes 


no 


no 


Add enhancements 


text, pic 


no 


NA 


NA 



OVERALL IMPRESSIONS (O-S) 

Ease of use 3 5 

Program features 4 5 

Documentation complete 4 5 

Documentation clear 4 5 
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SEQUENCER COMPARISON CHART 



# iha 9 y 



/ 



w( 






V 



t 



GENERAL FEATURES 



Version reviewed 


1.0 


425 


1.0 


2.10 


1.3 


Cost ($) 


65.00 


49.95 


39.00 


99.00 


69.00 


# Tracks 


20 


1 


8 


32 


16 


Event capacity 
(520ST) 


27,000 


250,000 


? 


30,000 


% 


Need TOS in ROM 


yes 


no 


yes 


yes 


yes 


Copy protected 


no 


yes 


yes 


no 


no 


GEM utilization 


full 


no 


some 


full 


full 


Allow desk 


yes 


no 


no 


yes 


yes 


Keyboard mouse 
equiv. 


P 


all 


P 


P 


some 


SET-UP 


MIDI system 
commands 


no 


no 


yes 


yes 


yes 


Set instrument modes 


yes 


no 


no 


yes 


no 


MIDI slow option 


no 


no 


yes 


yes 


no 


Sync to external 
device 


no 


no 


yes 


yes 


no 



Song pointer 
Beats/measure rant 
Tempo (beats/min) 
Metronone 



NA 
1-480 



1-999 
10-999 



1-16 
12-480 



1-99 
40-213 



Free memory 
indicator 


yes 


yes 


no 


yes 


yes 


Format data disk 
DATA ENTRY 


yes 








no 


Count-in 


no 


no 


yes 


yes 


yes 


MIDI channels/track 


1 


1-16 


1-16 


1 


1 


Set cue point 


no 


no 


yes 


yes 


yes 



Punch in/out 


no 


no 


no 


yes 


no 


Data recorded: RT 


all 


all 


all 


all 


all 


Data recorded: ST 


all 


no 


all 


N,V,PC 


all 


Filtering 


no 


no 


CCAT 


AT 


all 


MIDI thru 


yes 


no 


yes 


yes 


yes 


Track name length 


16 


8 


8 


24 


NA 


Track protect 


yes 


no 


no 


yes 


no 


Mute/solo 


y/y 


n/n 


y/n 


y/y 


y/y 


Playback modes 


RT.ST 


RT 


RT.ST 


RT.ST 


RT 


EDITING 


Edit modes 


T,S 


no 


T,S,E 


T,S,E 


S,E 


Track manipulations 


C,M 


no 


C,M,D,R 


C,M,D,R 


no 



Transpose 
track/octaves 
Segment locaters 



yes/ 4 
FF.ME 



yes/1 yes/ 5 

marker ev list 



yes/5 

FF, 

RW,ME 



yes/8 
block 



Segment no 
manipulations 


CP 


CPJD 


CPJD 


C,M,D, 
ID,split 


Parameter scaling no 


no 


oil 


no 


no 


Event manipulations no 


no 


all 


N,PC 


all 


Time correct location yes 


no 


yes 


yes 


yes 


Time correct duration no 


no 


yes 


yes 


yes 


Event hordcopy no no 
OVERALL IMPRESSIONS (0-5) 


yes 




yes 


Ease of use 4 


3 


3 


5 


3 


Program features 3 


1 


5 


4 


5 


Documentation 
compete 4 


5 


4 


5 


4 


Documentation 

clarity 5 


5 


4 


5 


3 



HZ-Track ($65.00, Hybrid Arcs) represents the entry level 
for usable sequencers. This is a very workable 20-track tape 
recorder emulator. EZ-Track provides MIDI thru along with a 
track merge option; however, each track can only play on a 
single MIDI channel. You can do transposing, but only for the 
entire song rather than (or individual tracks (one track can he 
specified to be left unchanged, typically for drum machine 
data). This program makes no provision for editing segments 
within a track. One annoying point is that it won't automati- 
cally save your recordings; you must explicitly save each 
recording or it is lost. 

An excellent home sequencer is the MIDlsoft Studio 
($99.00, MIDlsoft Corporation; also distributed by Passport). 
This upgraded version of MlDlsoft's Metatracks program has 
substantially more features, including 32 recording/editing 
tracks with a variety of data editing options. (Editors note: A 



review of MIDlsoft Studio appears in the July issue of Antic's ST Re- 
source.) The program allows MIDI thru with filtering of after- 
touch data. It's extremely easy to use and has well-written 
documentation. There's full support of GEM, including desk 
accessories, along with synch to external devices and various 
MIDI system commands. MIDlsoft Studio supports count-in 
(starting free measures with a metronome) to give you a feel 
lor the music tempo before you start to play. You could use 
this program tor professional work with no apologies. Be sure 
to get the most recent version (2.f0), which includes the 
MIDI thru function and step-time editing. 

The MIDI Recording Studio ($39.00, Dr. T) is an entry-level 
sequencer program (as opposed to the professional -level pro- 
gram from Dt T, the Keyboard Controlled Sequencer. 
$195.00). MIDI Recording Studio supports Dr. T's well- 
deserved reputation for software that enhances the music cre- 



$Tm The ST Quarterly 



ation process. Its many unique editing features make it the 
most powerful of those 1 looked at- and for the lowest cost! 
The program is built around a MIDI event table containing all 
notes and controller changes that occur during recording. You 
can edit this table event by event, or apply an operation (such 
as velocity change! to a selected range of events. MIDI Record- 
ing Studio is the only sequencer 1 tested that allows parameter 
scaling. One application of this is to automatically ramp 
up/down note velocity over a music passage to create fade 
in/out effects. 

The whole setup is similar to a music data spreadsheet 
and it is enormously powerful. My only complaint is that it is 
not fully GEM-based; you'll have to spend some time before 
you'll be comfortable with the program, but anyone interested 
in home recording should try it. 

Super Conductor ($79.95, MichTron) is the most recent ad- 
dition to the ranks of economical sequencer programs. Its 
operation is more similar to that of professional level se- 
quencers than to a tape recorder emulator To use it, you rec- 
ord a section of music (simple fragment or entire song) which 
is saved as a block. You can then arrange these blocks in any 
desired order across the 16 MIDI channels, and edit music 
data within a block using the powerful event list approach. 
Super Conductor also allows for extensive filtering of note 
and/or controller data either during or post- recording. 

This block structure formatting is particularly useful il 
your song makes use ol looping or repeat segments. You can 
copy a block multiple times, edit it to include variations in 
tone and dynamics, and play it back simultaneously across 
multiple MIDI channels . The three internal (monitor) voices 
are provided as if you have three additional MIDI channels; 
you can use these to test-play blocks or as supplemental 
voices, It also has a provision to send and receive system ex- 
clusive data files, although this feature is not set up for novice 
MIDI users. 

In adopting the block music structure, a potential draw- 
back is that you may find Super Conductor requires too 
much effort for casual use. During recording, all channel 
identification is stripped from incoming data to facilitate 
block editing and relocation. This prevents simple record and 
playback; especially simultaneous input from multiple chan- 
nels, such as synths and a drum machine. For those who are 
willing to spend some time and want something beyond a 
MIDI tape recorder. Super Conductor is recommended as an 
alternative type of sequencer, which is especially good for 
realizing complex musical ideas. 

LIBRARIAN PROGRAMS 

A library management program is a repository for MIDI data; 
it can be either free standing or integrated within patch editor 
software. In this section, I'll only look at Tree-standing pro- 
grams. A librarian stores the control parameter data to initial- 
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ize synthesizer voicings. set drum machine patterns, and as- 
sign controller effects. Librarians can build composite files 
that contain system-exclusive data for each instrument to give 
the desired setup for a particular song. All you need to do is 
call up the appropriate file; with the press of a button you're 
ready to play. This makes a good librarian program in- 
dispensable for a MIDI-based system in live performance. 
Equipment that adheres to the MIDI 1.0 specification 
usually can be accessed by a generic librarian, rather than re- 
quiring a separate program for each instrument. Two notable 
exceptions are the Casio synthesizer line and Roland drum 
machines, both of which use nonstandard handshaking ► 



LIBRARIAN COMPARISON CHART 
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Version reviewed 


2.0 


1.1 


1.0 


1.0 
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150.00 
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64.95 
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Copy protected 
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no 
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no 
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yes 
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SET-UP 

Instruments supported 
Hard drive supported 
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REQUEST/MIDI FILE FUNCTIONS 
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Free memory indicator 


yes 
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NA 


NA 


MIDI slow option 


built-in 
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NA 


no 


Support folders 


no 


yes 


yes 


no 



Request files on disk 


no 


yes 


NA 


yes 


MIDI data buffer size 


350K 


310K 


NA 


NA 


Smart "buffer full" 
recovery 


yes 


no 


no 


NA 


Create composite 
MIDI files 


yes 


yes 


NA 


NA 


Request looping option 


yes 


yes 


NA 


NA 


File edit options 


CD 


D,F 


D.F 


D 


Name individual tracks 


NA 


NA 


yes 


NA 


OVERALL IMPRESSIONS (O-S) 


Ease of use 
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Program features 
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5 
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Documentation 
completeness 
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5 


5 
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Documentation clarity 


5 


5 


5 
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PUBLIC DOMAIN 
MIDI SOFTWARE 
AND SOURCES 



for those of you with a modem, there is a lot of MIDI soft- 
ware in the public domain that is definitely worth ac- 
quiring. It's also an easy way to try out some music soft- 
ware to get a taste of what the ST/MIDI connection can 
offer. Listed below are some of the better picks, followed 
by a couple of BBS systems for you to look into for pro- 
grams and general MIDI-related information. 

SOFTWARE 

MIDIDEMO.PRG-a music player program with a piano 
screen display that shows the notes highlighted as played; 
comes with 7 pre-recorded song files. 

CASIO.TOS-a voice librarian for the Casio CZ- 
101/1000; comes with a collection of patches. 

CZPATCH.PRG-a patch generator program with user- 
definable limits on a "weirdness" factor; 1 liked it better 
than CZ-Android for coming up with interesting new 
sounds. You'll play with this one all night. 

MIDlMIKE.PRG-a one-track sequencer program that 
comes with several song files; very good and better than 
some commercial programs. 

MUSIC STUDIO ,SNG FILES-more than 100 song files 
are available with new ones added weekly. 

MIDI-RELATED BBS 

MIDI WORLD NETWORK (213/826-4288)- run by 
Hybrid Arts but contains information for all MIDI equip- 
ment and computers. 

TACE (817/778-2506)-contains many MUSIC STUDIO 
song files and a collection of EZ-Track song files. 

GALACTIC IMPERIUM (718/851-5785)-good source 
for MIDI demo programs and music files; ST specific 
bulletin board. 

MIDWEST MIDI BBS (405/733-3102)-home base for 
the International Electronic Musicians Users Group; con- 
tains a tremendous amount of MIDI information and patch 
data for various instruments and computers; good source 
of industry news. 

In addition to these, there are also many files of interest 
on COMPUSERVE in both the Atari SIG and the Music Fo- 
rum SIG. 



specifications for system exclusive data transfer and need 
specialized software 

SYS/EX ($150.00, Key Clique) is a generic librarian pro- 
gram that has been out for other computers for some time 
and has now been ported to the ST. It's designed especially 
for use by performing musicians; since it's hard to find 
enough room for a mouse with an on-stage setup, the pro- 
gram uses keyboard menus rather than mouse-based input. 
You must create a short command file to request the parame- 
ter data for each instrument; once it's made, you can save the 
command file to disk for subsequent use After calling the 
desired command programs, one after another, it dumps each 
instrument's data into a composite MIDI file. By calling up the 
MIDI file at a later time, it can reset all instruments to their 
previous states. SYS/EX includes a manual supplement that 
gives the necessary command sequences lor many instru- 
ments. However, this program will not work with Casio syn- 
thesizers due to Casio's nonstandard protocol. (Editor's note: 
Those of you who own a Casio synthesiser should take a look at 
Tom Bajorass "MIDISAVE" in this issue of START. M1DISAVE is a 
Simple patch librarian which works with many synthesisers, includ- 
ing the Casio.) Despite the lack of frills and a somewhat ex- 
pensive price, this is a dependable program; I've given it a lot 
of field testing and can readily recommend it. 

The Data Dumpstor ST ($89.95, Music Service Software) is 
a similar program but with a full GEM implementation. It can 
hold up to 20 independent MIDI data files in memory, and 
comes with command files already on disk for many com- 
mon MID! instruments; you can create and store additional 
command files as needed. One very useful feature is the MIDI 
file send subprogram that works as a separate desk accessory. 
This allows instrument setup within other GEM-based pro- 
grams such as sequencers, and is an excellent innovation that 
I hope other MIDI software will incorporate. This program 
performs very well and is extremely easy to learn and use. 
particularly for a home studio. Like SYS/EX, though, it won't 
work with Casio synthesizers. 

The TR707 Dumpstor ST ($64.95, Music Service Software) 
is specifically designed to deal with the nonstandard protocol 
used by the popular Roland TR707/727 drum machines. It's 
essentially a specialized version of the Data Dumpstor ST 
with similar features and performance It can accommodate 
20 full dumps (four tracks each) from the TR707 in memory 
and allows you to name each individual track, if desired. 
There's also a desk accessory version for file uploading to the 
drum machine. The only commercial ST program now avail- 
able that can work with the TR707, this program is much 
cheaper than using the TR707's ROM cartridges and better 
than cassettes for storing your drum patterns. 

The Pro-Creator ($240.00, Steinberg Research, distributed 
by the Russ Jones Marketing Group) is an unusual program. It 
is primarily a random patch creator for the Yamaha DX-7/TX 
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series combined with a patch librarian. It is not a patch edi- 
tor. You can have it create totally new patches or make up 
variations on a set of existing patches. Only two patch banks 
are kept in memory at a time, which can be a hinderance 
when relocating patches to come up with new banks. It uses 
a hardware circuit board key for copy protection; it must be 
inserted into the cartridge slot for the program to boot. Keep- 
ing it in place does not seem to interfere with other ST 
software. 

Overall, I am not impressed with this program. The patch 
generator is an amusing toy, but not of much practical use 
without being able to edit and fine-tune the patch parameters. 
Pro-Creator is only barely acceptable as a librarian due to the 
two bank limitation and inability to address disk drives other 
than A. 

(Editor's note: In the Spring, 1987 issue of START, the Pro- 
Creator was incorrectly listed as a sequencer. Also, the zip code for 
the Russ Jones Marketing Group was incomplete. The correct ad- 
dress is at the end of this article.) 

THE CHARTS 

The accompanying charts compare the features of all these 
programs side by side. There's a separate chart for each type 
of software: players, sequencers, and librarians. Whenever 
possible I have tested and verified the features myself, rather 
than just listing the manufacturers' claims. 

COMING ATTRACTIONS 

A whole new group of MIDI programs are nearing comple- 
tion; by the time you read this article, many of them should 
be available. Below I have listed some of the software that 
should be brought to market soon. 

• EZ-Score 5T (Hybrid Arts): scoring program compatible 
with EZ-Track ST music files 

• FB-01 Editor/Librarian (Music Service Software): patch 
editor for FB-01 

• Four Patch + (Aegix): patch editor for Yamaha 4 operator 
synthesizers 

• MIDI-Edit (Electronic Music Publishing House); upgraded 
version of MIDIplay to include step-time music entry and 
additional editing features 

• MIDIsoft Enhanced Studio (MIDlsoft Corporation): ad- 
vanced version of MIDlsoft Studio 

• Samplemaker (Virtual Sounds Software): computer genera- 
tion of digital samples for Sequential Prophet 2000/2002, 
Akai S900, and Ensoniq Mirage samplers 

• Soundfiler S612 (Drumware): librarian/visual editing sys- 
tem for the Akai S612 sampler 

• XTRACK, XNOTES, XSYN (Beam Team): modular, in- 
tegrated software for sequencing, scoring, and patch editor 
for Casio CZ, Yamaha DX, and Roland JX synthesizers 



CODA 

Whether your interests are in music education, listening to a 
home jukebox, running a home music studio or just fooling 
around, there's ST MIDI for you. Sergeant Tramiels Lonely 
Hearts Club Band is sitting inside your computer, just waiting 
to take you awayl ■ 

IF YOU'D LIKE TO SEE MORE ARTICLES LIKE THIS ONE, 
CIRCLE 186 ON THE READER SERVICE CARD. 

REFERENCES 

• "The Ins, Outs. And Thrus Of MIDI" by Tom Jeffries, 
START, Spring 1987. 

■ MIDI For Musicians. $14.95 Craig Anderton, AMSCO Music 
Publications, 24 E. 22nd St. New York, NY 10010 1986. 
(212)254-2100 

CIRCLE 1B7 ON READER SERVICE CARD 

■ Keyboard Magazine (see especially the synthesizer glossary 
in the February and March 1987 issues), 20085 Stevens 
Creek, Cupertino, CA 95014, (408) 446-1105. 

CIRCLE 188 ON READER SERVICE CARD 

• Electronic Musician Magazine (a TR707 librarian program 
for the ST was in the February 1987 issue), 2608 Ninth St., 
Berkeley, CA 94710. 

CIRCLE 189 ON READER SERVICE CARD 

• introduction to MIDI ftrgrommtng, Abacus Software, Inc., 
PO. Box 7219, Grand Rapids, MI 49510. (616) 241-5510. 

CIRCLE 190 ON READER SERVICE CARD 

LIST OF MANUFACTURERS 

• The Music Studio 
Activision, Inc. 

2350 Bayshore Parkway 
Mountain View, CA 94039 

(415) 960-0410 

CIRCLE 191 ON READER SERVICE CARD 

• Four Patch 4- 
Aegix 

P.O. Box 9488 
Reno, NV 89507 
(702) 329-1943 

CIRCLE 193 ON READER SERVICE CARD 
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• XTRACK, XNOTES, XSYN 
Beam Team 
6100 Adeline Street 
Oakland, CA 94608 
(415)658-3206 

CIRCLE 194, 195, 196 ON READER SERVICE CARD 



• SYS-EX 

Key Clique Inc 

3960 Laurel Canyon Blvd., Suite 374 

Studio City, CA 91604 

(818) 905-9136 

CIRCLE 207 ON READER SERVICE CARD 



• MIDIsoft Studio 
Passport 

625 Miramontes Street 
Half Moon Bay, CA 94019 

(415)726-0280 

CIRCLE 215 ON READER SERVICE CARD 



• MIDI Recording Studio, 
Keyboard Controlled Sequencer 
Dr T's Music Software 

66 Louise Road 
Chestnut Hill, MA 02167 
(617) 244-6954 

CIRCtE 197, 299 ON READER SERVICE CARD 

■ Soundfiler S612 
Drumware 

12077 Wilshire Blvd., #515 
Los Angeles, CA 90025 
(213)478-3956 

CIRCLE 201 ON READER SERVICE CARD 

• MIDlplay, MIDl-Edit 
Electronic Music 
Publishing House, Inc. 

2210 Wilshire Blvd., Suite 488 
Santa Monica, CA 90403 
(213)455-2025 

CIRCLE 202, 203 ON READER SERVICE CARD 

• EZ-Track, EZ Score ST 
Hybrid Arts, Inc. 

11920 West Olympic Blvd. 
Los Angeles, CA 90064 
(213) 826-3777 

CIRCLE 204, 205 ON READER SERVICE CARD 
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■ Super Conductor 
MichTron 
576 S. Telegraph 
Pontic, MI 48053 
(313) 334-5700 

CIRCLE 208 ON READER SERVICE CARD 

• MIDI Magic 

Micro-W Distributing, Inc. 
1342B Route 23 
Butler, NJ 07405 
(201)838-9027 

CIRCLE 209 ON READER SERVICE CARD 

• MIDIsoft Studio, 
MIDIsoft Enhanced Studio 
MIDIsoft Corporation 

R O. Box 1000 
Bellevue, WA 98009 
(206)827-0750 

CIRCLE 210, 211 ON READER SERVICE CARD 

• Data Dumpstor ST, TR707 Dumpstor, 
FB-01 Editor/Librarian 

Music Service Software 
801 Wheeler Road 
Madison. WI 53704 
(608) 241-5615 

CIRCLE 212, 213, 214 ON READER SERVICE CARD 



• Pro-Creator 
Steinberg Research 
Distributed by: 

Russ Jones Marketing Group 
17700 Raymer St., Suite 1001 
Northridge. CA 91325 
(818) 993-4091 

CIRCLE 216 ON READER SERVICE CARD 

• Samplemaker 

Virtual Sounds Software 
557 Tremont, Suite 11 
Boston, MA 02118 
(617)353-1815 

CIRCLE 217 ON READER SERVICE CARD 

• ST Music Box 
XLEnt Software 
P. O. Box 5228 
Springfield, VA 22150 
(703) 644-8881 

CIRCLE 218 ON READER SERVICE CARD 
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'What's wrong with 
copying software?" 



"I use a lot of programs on my personal computer, and 

I copy them all the time." 

"I'm a programmer. Every time you copy one of 

my programs, you're taking away my income — 

I depend on sold programs for a living." 

"Oh, come on. I bought it: I have a right to copy it." 

"You do have a right to make a back-up, that's true. 

But when you start copying programs for your 

friends and co-workers, that's breaking the law." 

"What law? Any copying I do is in the privacy of my own 

home." 

"It doesn't make any difference where you do it. 

Every time you copy a program without permission 

from the publisher, you're committing a federal 

offense." 

"That's all right, I won't get caught." 

"You're missing the point. The issue isn't "What 

can I get away with?" — it's "who am I hurting?" 



Remember, lots of people worked hard to produce 

every program you use: designers, programmers, 

distributors, retailers, not to mention all the 

people who support users. They have a right to be 

compensated for their efforts, and their major 

compensation is through software sales." 

"Well, I don't mean to hurt all those people — or anyone, 

really." 

"Unfortunately, that's what copying does: it hurts 

people. And, ultimately, it hurts people like you, 

who want new and innovative software." 



Do you copy 
software? 
Think about it. 



The unauthorized copying of software is a crime. 



cl by Halcyon Associates. Brooklyn, New Yofk 
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PACKTEXT 

TEXT COMPRESSION AND 

HUFFMAN CODING WITH 

PERSONAL PASCAL 



by Dan 



M a I e i k a 



^fl completely CEM- 
based compression 
program for compact- 
ing text files; includes a 
lucid introduction to in- 
formation theory Huff- 
man encoding, the 
ASCII character set, 
and tree structures. You 
can find the compres- 
sion program and the 
voluminously com- 



ited >. 



' code i 



your START disk. 




BFile PACKTEXT.ARC 
on your START disk 



HI'aki I'beSI (Irttinerli 



In the 1940's, Claude E. Shannon 
of the Bell Technical laboratories 
devised a set of theorems which 
sprouted a new branch of science called 
information theory. Shannon's work 
showed, among other things, that many 
messages are redundant, they contain 
more information than is really needed. 
Once redundant patterns are recog- 
nized, they can be encoded more 
efficiently. 

PACKTEXT is a file compressor and 
decompressor. It strives to remove 
much of the redundancy within a text 
file. It can pack large files into consider- 
ably less space without loss of data. It 
will also, handily, read its own packed 
files and return them to their original 
form. While designed specifically for 
use with ASCII text, it will work on any 
data, though it may actually create larger 
files. 

This technique is widely useful and 
can be directly incorporated into other 
applications. For example, a RAM-based 
database could use packed data, un- 
packing only one record at a time for 
display or processing, and expand its 
capacity by perhaps 40% before tack- 
ling the complications of going to a 
disk-based system. This technique 
could also be the basis for a data en- 
cryption scheme, since it isn't immedi- 
ately obvious what the original text 
looked like, 

THE CONCEPT 

Most micros use the ASCII character set 
to save, transmit, and otherwise 
manipulate text. The standard ASCII set 
contains 95 unique characters: 26 up- 
percase letters, 26 lowercase, 10 digits, 
the space, plus 32 punctuation marks 
and other symbols of dubious useful- 
ness. The computer represents each 
character as a unique binary code, and 
9^ distinct symbols oi any type require 
at least seven bits to encode (2 b < 95 
<=2 7 )- Notice that the only correlation 
between any seven bit code and the 
character it is intended to represent is a 



matter of interpretation. A pattern of 
seven bits could just as easily be the be- 
ginning of a color palette, part of a 
DEGAS picture, or just random gibber- 
ish. The whole idea behind ASCII was 
to invent 95 different bit patterns, as- 
sign some meaning to each, and attempt 
to make the whole thing appear as if it 
were conceived by a guiding intel- 
ligence. 



There's nothing 

really sacred about 

"01100101" 

after all. 



The Atari ST is constructed so the 
smallest addressable unit of memory is 
the byte: eight consecutive bits. If you 
only want seven bits, you'll have to ac- 
cess the whole byte and pick out the 
ones of actual interest once they're all 
inside the CPU. 

Since the smallest convenient chunk 
ol addressable memory (eight bits) is 
only barely larger than the smallest 
chunk necessary to encode an in- 
dividual ASCII character (seven bits), it 
makes sense to represent a character 
with eight bits instead of seven. Eight 
bits allow 2 W = 256 distinct patterns to 
be represented, so 256 different charac- 
ters are representable in such a charac- 
ter set. The standard ASCII set defines 
the first 7 bits worth: the 95 so-called 
"printable" characters plus 33 control 
characters (whose exact meaning is ol- 
ten questionable) for a total of 128. 
Since we have an unused bit, many 
computers define an additional 128 of 
their own to fill out the remaining 
space. 

In a text file, for example, each sepa- 
rate character is encoded by the ASCII 
pattern lurking in a byte of memory 



somewhere-one pattern to a byte. The 
hardware and software that scans mem- 
ory, finds a byte of some value, recog- 
nizes it as printable character, and then 
rearranges the pixels on the screen to 
look like that character, is something 
else entirely. It is only a matter of con- 
vention that the bit pattern "01100101" 
looks like an "e" on a screen or printer. 

MAKING IT SMALLER 

Compression depends on finding a 
more space-efficient method ol 
representing data. Different techniques 
work on different types of data. If it's 
ASCII text compression, we want to find 
some sort of encoding method in 
which, on the whole, less than eight bits 
are required to represent each in- 
dividual character. There's nothing really 
sacred about "01100101," after all. 

If you were to analyze a large body of 
text (this magazine, for example) a pat- 
tern would emerge. Some letters appear 
more often than others, and some might 
not appear at all. In the English lan- 
guage, the letter "e" is the most com- 
mon. Generally, about 13% of all letters 
in a "typical" English text will be "e." "e" 
is followed in frequency of use by "C at 
about 10%, "a" at about 8%, and then 
about 23 others, down to "z" at less 
than 0.1%. PACKTEXT takes advantage 
of this frequency distribution. 

As mentioned before, in 
ASCII text files, all characters 
are encoded as a sequence 
of eight bits. This is just a function of 
the design of the character set, and a 
matter of convenience. If fewer than 
eight bits were used per character, the 
result would of course be a shortened 
file. In fact, since the "printable" ASCII 
characters are all contained within the 
first 128 members of the set, a "printa- 
ble" ASCII file can immediately be 
shortened 12% by simply lopping off 
the high bit and packing the remaining 
seven together. ► 
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PACKTEXT... 

HUFFMAN CODES 

Consider a system using fewer than 
eight and even fewer than seven bits to 
represent each of the characters of the 
ASCII set. Only an unforgivably small 
subset of the ASCII set can be contained 
in a scheme using only three or four 
bits per character, but consider a system 
in which not all characters use the same 
number of bits, where some are 
repiesented by as few as three or four, 
and others by as many as L4 or 15. 

Huffman Codes use the smallest num- 
ber of bits practical for commonly oc- 
curring characters and necessarily more 
bits for the less common ones. These 
unevenly sized codes can then be 
glommed together, disregarding simple 
matters of convenience like bit 
boundaries. 

How can we determine how many 
bits to use for each character? And, how 
can we construct the table of packing 
codes so that it will be clear where the 
border lies between separate characters? 
Both problems are nontrivial. If we can 
accomplish them, and the text to be 
compressed cooperates by being some- 
thing more than purely random gibber- 
ish, as often happens with useful infor- 
mation, a practical data compression 
scheme emerges. 

The second problem is the eas- 
ier of the two. In fact, it may be 
trivial. The delineation of codes 
is accomplished by constructing the ta- 
ble so that no packing code begins with 
a sequence of bits that is the same as a 
shorter code. For example, if the code 
lor "e" the most common letter and 
therelore the owner of the shortest code, 
is three bits, say "000" then no code for 
any other letter can begin with the same 
sequence "000" Other, longer codes can 
contain that sequence, but to ensure 
each unique character has a unique, 
recognizable pattern in the packed bit 
stream, none can begin with it. 

If "t," for example, was encoded as 
"0001" it would be unclear if that pat- 



tern meant "t", or "e" followed by the 
beginning of something else. Perhaps 
the decoding algorithm could be clever 
enough to know the difference. PACK- 
TEXT certainly isn't. However, if "t" was 
encoded as "10001," even though it con- 
tains the sequence "000" (which could 
mean "e"), by the time the decoding al- 
gorithm gets that far it should realize it 
isn't an "e," All we need to know is 
where the character begins in the 
packed bitstream and that the opening 
sequence of each character is unique. 

FIGURE 1 

Character Frequency 

(packing) of 

Code Occurrence Huffman 

blank 17.9% 00 

e 9.5% 010 

t 7.4% 011 

s 5.5% 10000 

5.5% 10001 
a 5.5% 10010 
i 5.1% 10011 
n 4.7% 10100 
r 4.5% 10101 
h 3.5% 10110 
c 3.2% 10111 

1 3.1% 11000 
d 2.4% 110010 

u 2.1% noon 

m 1.8% 110100 

f 1.7% 110101 

Carriage Return 1.7% 1101 10 

Line Feed 1.6% 110111 

b 1.6% 111000 

p 1.5% 111001 

g 1.2% 1110100 

This is where the trick in determin- 
ing just how many bits to use for each 
packing code comes in. If "e" is en- 
coded as just mentioned, then all the 
other seven possible combinations of 
three bits are available as starting se- 
quences for other characters. If less 
common characters are encoded with 
more bits and don't begin with the se- 
quence "000," then additional charac- 
ters can be accommodated. If instead 
the next most common character, prob- 
ably "t" is also encoded in three bits, 
perhaps "001" then, even if the jump to 
four bits is made immediately after- 
ward, we are only left with room for 
twelve more unique starting codes 
(0100-1111). The trick is to determine 
the optimum length for the shortest 



packing code, and when to make the 
jump to longer codes for subsequent 
less common characters. Our hope is 
that the more common characters are 
common enough so that the less com- 
mon ones (which will no doubt require 
more than the original eight bits to rep- 
resent), won't weigh down the entire 
scheme and actually produce a longer 
packed file. 

A well-constructed Huffman 
Code for "typical English 
text!' consisting of all capital 
letters and nothing else, will require an 
average of about 4 bits per character, 
thereby shortening the entire text file by 
nearly 50%. A similarly well- 
constructed code for text such as this 
article, which includes characters of 
both upper case, lower case, and punc- 
tuation marks, will require about 5 bits 
per character: a 35% savings. "Average 
bits per character" refers to the length of 
each character code weighted by its fre- 
quency of use; it is indicative of the to- 
tal length of a packed text file. 
Specifically, it is the sum of the prod- 
ucts of the normalized Irequency of oc- 
currence of each character and its corre- 
sponding code length. 

A CLOSER LOOK 

As an example of a Huffman Code, an 
analysis of an early version oi this arti- 
cle yielded the table of packing codes in 
Figure 1, truncated at the point where 
Frequency of Occurrence drops below 
1%. Packing efficiency was better than 
40%, with the average character requir- 
ing about 4.5 bits to encode. 

Two things jump out from this table. 
First, carriage returns apparently out- 
number linefeeds. This I attribute to 
roundoff' error. Second, the Huffman 
Codes illustrate that no code begins 
with a bit sequence which duplicates a 
shorter code. 
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GENERATING UNIQUE 
CODES 

If, before constructing the actual codes, 
the desired length of each code is al- 
ready known, and the table is con- 
structed in order from shortest code to 
longest, then each code is just the previ- 
ous code +1, shifted left if it is longer, 
"e" for instance, is "010." The next char- 
acter, "t," is "e" +1, or "Oil." The next 
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character, "s," is "t" +1, or "100" except 
that at this point we want to begin using 
five bits instead of three, so enough 
zeroes are tacked on to the end to make 
up the difference with "10000'' The first 
n bits in a code, where n is the number 
of bits used by the immediately preced- 
ing code (and is less than or equal to 
the number of bits in the current code) 
must be unique The following bits, if 
any, can be anything at all, but zeroes 
are always used here because that al- 
lows the simple operation of adding 1 
to get the subsequent code 

We need not begin with 0; we could 
instead begin at the other end with 2, 
— 1, or anywhere in between. The prob- 
lem with beginning anywhere in be- 
tween is just remembering which pat- 
terns have already been used, and not 
reuse them while casting about for the 
T\ext unique sequence If we begin at 
one of the ends, then the simple task of 
incrementing (or decementing) by one 
each time guarantees a unique pattern. 
With such a scheme, as long as the 



addition of 1 to the previous code never 
causes a carry, or ovofiow, into more bits 
than were expected, then no code will 
ever have another shorter code as its 
opening sequence. An overflow occurs 
when n bits, all l's, are incremented. 
The result is a 1 followed by n 0's, 
which contains as its opening sequence 
a bit pattern already used. The bottle- 
neck in this process is actually deter- 
mining how long each code should be; 
where to jump to a longer code early 
enough to prevent pattern repetition 
(overflow) but late enough to avoid an 
unnecessarily long average code length. 

DETERMINING OPTIMUM 
CODE LENGTH 

Directly stated, the optimum number 
of bits b necessary to encode a charac- 
ter with a normalized probability of oc- 
currence p is given by: 

b=-l°g 2 p 

As an example, the table we looked 
at earlier shows that the most common 
character, the blank, makes up 17.9% of 
the file. It would optimally be encoded, 
then, with -log, 0.179=2.5 bits. Be- 
cause rounding down would cause the 
overflow problem mentioned above, we 
can round up instead to get blank en- 
coded in 3 bits. Notice, however, that in 
the above table it is actually encoded in 
2 bits. PACKTEXT determines the 
length of each code should be by start- 
ing with ceil(-log 2 p) bits as an ap- 
proximation, then attempts to use less 
and see how much can be gotten away 
with. A dash of brute force always helps 
any recipe. 

I won't attempt to derive the for- 
mula for b because I'm not certain 
1 can. Rather, I present a few sce- 
narios designed to make it more palata- 
ble. Consider a case in which only eight 
characters need to be packed, and they 
all occur with equal frequency. Each 
character would have a normalized 



probability of occurrence of 12.5%, so 
each character should be encoded with 
— log 2 0T25 = exactly three bits. Funny 
that exactly eight combinations are 
available using exactly three bits. Drop a 
few probabilities, thereby increasing 
some others, and the equation moves 
around in a suitably accommodating 
direction. 

if only seven characters ol all equal 
probability were being packed, the for- 
mula suggests 2.81 bits apiece. 2 :HI =7. 
Too bad. We must use an integral num- 
ber of bits, so PACKTEXT would begin 
with all seven using three bits, then 
drop the first one to two just because it 

UNPACKING 

The only remaining problem is invent- 
ing a decent algorithm for unpacking 
the packed text. PACKTEXT traverses a 
binary tree to accomplish this feat. Fig- 
ure 2 shows an unpack tree correspond- 
ing to the table in Figure 1. 

To traverse this tree and find the sur- 
prise character at the end, begin with 
the root node and the most significant 
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bit. At each node take the left branch for 
a and the right for a 1. For example, 
given the bit sequence '10110101'' be- 
gin with the top node and take the right 
branch. From there, take the left. Take 
the right from there, the right from 
there, and the left from there, and that 
was an "h" The following bits, "101" 
must be the beginning of another 
character 

The shortcoming ol the incrementing ► 
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PACKTEXT... 

technique used by PACKTEXT to deter- 
mine unique codes now becomes ap- 
parent. It produces a severely im- 
balanced unpack tree. With only a few 
branches on the left of the root node, 
there are hundreds to the right. This 
means that the average number of 
nodes which must be visited to decode 
a character is higher than it could be, 
and, subsequently, it takes a little longer 
and uses a little more computer time to 
unpack than it might. 

This unhappy nuance is balanced by 
the fact that the scarce branches to the 
left correspond to the most commonly 
used characters and are therefore more 
heavily traveled than the lengthier paths 
to the right. Regardless, the time re- 
quired to traverse this tree for each 
character in the packed bitstream is eas- 
ily overshadowed by the time required 
to read and write the disk files them- 
selves. 
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PROGRAM OPERATION 

PACKTEXT is useful for compressing 
and restoring ASCII text files and possi- 
bly any data file in which data is stored 
by bytes. It would theoretically be of lit- 
tle use compressing files which arerit 
arranged by the byte, such as picture 
files. Nevertheless, for some reason, 
PACKTEXT seems able to compress 
most pictures, regardless of the theory 
which guided the program's inception. 
The DEGAS picture "COMET' a very 
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nice medium-resolution picture on my 
copy of the distribution disk, is packed 
to 55% of its original size, including the 
custom IK code table. The source listing 
for PACKTEXT, a file of the type the 
program was designed to handle, is it- 
self only packed to 68% of its original 
size. For that matter, the program file 
PACKTEXT.PRG, as random a collection 
of gibberish as any (although 25% 
zeroes) shrunk to 80% of its original 
size when presented to its own mercies. 
Strange how things work out, 
sometimes. 

PACKTEXT can also be used for ex- 
perimenting with Huffman Codes, and 
performing some character analysis on 
text files. 

Packed hies may or may not contain 
the Huffman Code Table which was 
used to pack them. You can analyze just 
one large, representative text file and 
store the resulting code table for use 
with all text files. On the other hand, a 
user can analyze each file to be packed 
and store the code table used for that 
file along with the packed text itself. A 
more efficient packing would probably 
be achieved using the last method, but 
IK will be lost to the table. You choose. 

To create a file which is just a code 
table stored on disk for later use, select 
"Generate Huffman Codes" from the 
"Codes" menu. The program will 
prompt for the name of a text file to 
analyze. Once that process is finished, 
select "Save Huffman Codes" from the 
"File" menu. Once again, a name is 



prompted for. This creates a IK file 
which you can reload for later use at 
any time 

To use such a code table, select 
"Load Huffman Codes" from the "File" 
menu; then select "Includes Codes in 
FileT which will deactivate that item 
(which wakes up activated and checked 
in the menu). Now any file that is 
packed or unpacked will use that code 
table and will not include it in the 
packed hie itself. 

To pack files using tailored code 
tables, and this is the recom- 
mended method, first make cer- 
tain "Include Codes in File" under the 
"File" menu is checked. Select "Pack a 
File" from under the "File" menu. 
PACKTEXT will prompt for the name ol 
the file to be packed, and the name of a 
file to be created, then will build the 
code table and pack the hie. 

To unpack such a file, just select 
"Unpack a File" from the "File" menu. 
Whether or not "Include Codes in File" 
is checked, the code table from that file 
will be loaded and used to unpack it. 
Once again, the name of the packed file 
and a name for the newly created un- 
packed hie will need to be entered. 
Note: If a Huffman Code Table is 
stored in the packed file, the entire table 
(IK) is stored, not just the first part that 
contains the characters actually used. 
This would seem a waste since the en- 
tire object behind the program is to save 
disk space. It is nevertheless done this 
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way because using a truncated code ta- 
ble on text, other than the specific text 
it applies to, can cause much grief if the 
other text includes characters not al- 
lowed for in the table. Since the code ta- 
ble from the packed file is retained until 
replaced by some other table, it's possi- 
ble to do just that. 

Source code is included, so 
anyone who wishes can fix 
this minor shortcoming. In do- 
ing so, the basic operation of the pro- 
gram will need to be changed 
somewhat. 

PACKTEXT maintains three in- 
dividual windows for display of in- 
teresting data and obtains all its instruc- 
tions through a GEM menu bar. 
Available commands are: 

• Analyze a text file to create a 
Huffman Code specially tailored for that 
file. ("Generate Huffman Codes"). 

• Print the Huffman Code Table cur- 
rently in use. ("Print Huffman Codes"). 

• Pack a file. ("Pack a File") 

" Unpack a file. ("Unpack a File"). 

• Store the current Huffman Code Ta- 
ble in a file all by itself. ("Save Huffman 
Codes"). 

• Retrieve a code table stored by the 
previous command. ("Load Huffman 
Codes"). 

• Open or close any of the three dis- 
play windows. Some time savings is 
gained during packing and unpacking 
by closing the "Unpacked Text" 
window. 

• Quit. Always handy in any program. 

• A final menu option toggles whether 
or not the Huffman Code Table is 
stored along with the packed text in a 
packed file. 

The Huffman Code Table currently 
in use, whatever its origin, is always dis- 
played in the window entitled 
"ttuSman Codes!' 

When a text file is packed or un- 
packed, the first MAXTEXT (#defined 
as 3000) characters of the unpacked 
file are displayed for your amusement 



in the window entitled "Unpacked 
Text." 

The third window, entitled "Pack 
Data," contains statistics Irom pack and 
unpack operations. It shows the length 
of the unpacked text, in bytes, and the 
length of the packed data, also in bytes. 
In addition, the ratio of the length of the 
packed text to the unpacked text, 
labeled "packing efficiency!' and the 
theoretical efficiency of the Huffman 
Code, labeled "efficiency rating!' are dis- 
played. This theoretical efficiency is the 
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sum for each code (the product of its 
normalized frequency of occurrence 
and the length of its code in bits), all 
divided by eight; the number of bits in 
an unpacked ASCII character The result 
is a ratio which, when multiplied by the 
size of an unpacked file, gives the theo- 
retical size of the corresponding packed 
file. 

THE PROGRAM ITSELF 

PACKTEXTs actual workings are left to 
the intrepid reader to wrestle from the 
included program listing. An exhaustive 
walkthrough exceeds the editorial space 
allotted lor a single article. Nevertheless, 
for the impatient or unwilling, a few 
notes about the program's operation are 
in immediate order. 

PACKTEXT allows the option of sav- 



ing the Huffman Code Table itself along 
with the data in each packed file. Doing 
so increases the size of each by IK but 
allows trouble-free use of customized 
code tables. The final result may well be 
a shorter file. 

One can also store on disk by itself a 
single Huffman Code Table gleaned 
from an analysis of a single representa- 
tive data file, storing only the data in 
each packed file. One can also simply 
use the default code table the program 
wakes up with, not storing any tables 
on disk. 

With the "Include Codes in File" 
menu item checked, when the program 
is told to pack some data file, it will 
automatically analyze it, creating a cus- 
tomized code table, before packing 
begins. 

The "Generate Huffman Codes" 
menu item performs only the analysis, 
creating a customized code table for 
some data file. "Save. . " and "Load 
Huffman Codes" store and retrieve just 
the code table itself. 

Also of interest is the precise 
meaning of the "efficien- 
cies" the program is always 
calculating. "Efficiency rating" is the 
theoretical ratio of packed file size to 
unpacked file size, calculated from the 
frequency table and code lengths. 
"Packing efficiency" is in fact the actual 
ratio achieved during the last pack (or 
unpack). If a code table is retrieved 
from disk, the efficiency rating will be 
totally inaccurate because the frequency 
table isn't saved, in the interests of con- 
serving space. 

CONCLUSION 

PACKTEXT is a versatile program that 
will certainly find use in some situa- 
tions. Its most endearing social grace 
lies in the actual code used to compress 
and restore files. 1 hope the readers of 
START can use my examples to develop 
their own packing programs. How 
much can you squeeze down your data? 
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ISK INSTRUCTIONS 



^^^™ very issue of START, The ST Quarterly, contains 
^V ■ articles written by some or the finest developers and 
m^Ki writers in the Atari computer community. Many of 
these articles are programming tutorials, detailing how the 
wizards of the Atari world practice their arcane art. But any- 
one can benefit from the disk-we provide everything from 
tax templates for your spreadsheet to full-featured word 
processors, easy-to-use drawing programs and spectacular 
graphics demos. 

START was designed as a magazine with disk, containing 
the finest ST programs available. If you purchased the- $4 non- 
disk version of START you can still obtain the disk by sending 
us the bound-in order card or mailing $10.95 plus $2 for 
postage and handling to: START DISK #5, 544 Second Street, 
San Francisco, CA 94107. (Be sure to specify the disk you 
want.) Note: If you want same day service, call (415) 957- 
0886 and ask for the Disk Desk. Give us your MasterCard or 
Visa number, and we'll send your START disk out that very 
day! 

All programs on the START disk are for your own private 
use, and are not public domain. Please don't copy your disk 
for your friends, accept a copy from someone, or upload these 
programs on a bulletin board system. That makes it more 
difficult for us to afford to bring you quality ST programs and 
incisive technical material. Software piracy hurts everyone. 

GETTING STARTED 

Use scissors to open your disk envelope along the outside 
vertical edge, then put the disk in drive A and double-click on 
the disk icon to see its contents. Refer to your ST owner's 
manual il you're uncertain about using the Desktop. 

Important: Before you do anything else, back upyour 
START disk- it's not copy-protected. Format a fresh disk as 
single-sided, and copy your entire START disk to it. Finished? 
Now place your original START disk in a sale place and begin 
using the new copy. 

WHEREFORE ARC THOU? 

In each issue of START, our pages for features, departments 
and reviews are at a premium- and our disk space for pro- 
grams is as precious as lemonade in the Sahara. We have to 
fit a lot of programs on every START disk, and to do that we 
compress the files into archives. 

The ARC system was originally developed for MS-DOS 
computers, and was implemented on the ST by Harvey John- 
son of Palm Bay, Florida. With ARC you can compress many 
different files together into a single file, reducing the total size 
by 40 percent or more-and then later expand the file back 



into its original parts. We chose ARC because it's efficient and 
bulletproof- the same reason it's CompuServe's preferred 
compressor/librarian. You can download a complete set of 
ARC utilities from CompuServes ATARI 16 forum and many 
other online services and bulletin boards. It's also available lor 
$12 (plus $3 postage and handling) from The Catalog, which 
is bound into the middle of this issue of START. 

You'll find the program ARCX.TTP on your START disk- 
it's a compact version of ARC that can only decompress ARC 
files. Using it is simple. Suppose there's a file on the START 
disk called FOO.ARC. To un-ARC it, first copy FOO.ARC and 
ARCX.TTP to a freshly formatted disk. Double-click on 
ARCX.TTP, then type in the name of the file you want to 
decompress, FOO.ARC, and press the Return key. ARC will 
un-ARC the files inside FOO.ARC and place them on the 
disk. That's all there is to it! 

ON THE DISK 

• ARCX.TTP The unARCing utility. Double-click on 
this to decompress a file. 

• BENCHMRK.ARC Dave Plotkin works for the oil 
industry, and he's one slick programmer In this issue's 
BASICs for the ST, Dave pits five different versions of BASIC 
against each other in mortal combat. These are the bench- 
marks he used, for Fast ST BASIC (FSTBSTST.BSC), GFA BA- 
SIC (GFABASTS.BAS), standard ST BASIC and the LDW com- 
piler (STBASTSTBAS), and SoftWorks BASIC 
(SWBASTST.BAS). 

• CLI.ARC What's better than getting WordPerfect 
early? How about a peek over the shoulder of the man who 
programmed it? In Escape From the Desktop, Jeff Wilson 
brings an IBM-style Command Line Interpreter to the ST. 
Here's the working desk accessor)' (CLI.ACC) and the 
assembly-language source (CLI.ASM and MACROS.CLI), 
which include scads of programming examples for accessing 
TOS-level file handling routines. 

• DECOMM. ARC Imagine using a great product for 
a while, and then discovering a whole new side to it. Tom 
Hudson designed DEGAS Elite and the new CAD-3D Version 
2.0 so other programmers could easily hook into them, and 
In Plumbing GEM's Mysteries he shows how you can do it 
yourself. DECOMM. ACC is a sample "test everything" desk 
accessor)', and DECOMM.C is its source code in Alcyon C. 

• FLICKER. ARC Jim Kent, author of Animator ST 
irom Aegis, jumped at the chance to demonstrate how basic 
animation is performed on the Atari ST in Flicker. The pro- 
gram FLICKER.PRG is where it all comes together, and 
GRAMMA.SEQ and WINK.SEQ are sample animation files. 
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But to see how Jim created this marvel in Aztec C, choose a 
long, sultry summer afternoon to examine the 35 (gulp!) 
source files: ABLtT.C, AL1NE.ASM, ALINE.H, BRUSH.C CEL- 
PULLC, CIRCLE.ASM, CLIPS.C, CLOCK.ASM, CONVASM, 
DISK.ASM, DRABRUSH.ASM, FASTRAND.ASM, FILEREQ.C, 
FILES.C, F1NDCOLC, FLICKER.H. FOO.C FRAMES.C, 
GFX.ASM. INIT_5YS.C INPUT.C, MA1N.C, MEMORY.C. MUL- 
TIOPS.ASM, PENTOOLS.C, POLAR. ASM, PR1M.C, PULL.C. 
PUTDOT.ASM, SINE.C, 5QR_ROOT.C. STRETCH.ASM. UN- 
DERMOU.ASM, ZOOM.ASM, and ZOOMTAB.ASM. There's 
also MAKEFILE and FL1CKER.LNK, which Aztec C uses to 
sew them all together 

• MIDISAVE. ARC In Save Your Synthesizer 
Sounds, Tom Bajoras of Hybrid Arts shows you how to use 
your ST to remember patch settings for MIDI synthesizers like 
the Yamaha DX7 and the Casio CZ101. Tom's MIDI generic 
patch editor, MIDISAVETOS, is here along with the source 
code in C (l.C) and assembler (2.S). 

• PACKTEXT. ARC You can't fit two gallons of water 
in a one gallon jug, but Dan Matejka's Packtext shows how to 



fit two hies in the space one would normally take up. Dun's 
text compression program (PACKTEXT.PRG) and C source 
code (PACKTEXT.C) demonstrate some of the techniques 
used in full-scale compression systems like ARC 

• TOOLKIT. ARC START Technical Editor Patrick 
Bass heard Tom Hudson talking about the DEGAS Elite pipe- 
line, and sat down to create A Super Toolkit for DEGAS Elite. 
Patrick's toolkit contains two desk accessories: a Screen Oper- 
ator named OPERATOR.ACC (the Alcyon C Source files are 
OPERATOR.C and OPERATOR.H, and youll need the re- 
source file OPERATOR R5C to run the desk accessory) and a 
Page Flipper named PAGEFLIRACC (Alcyon C source 
PAGEFLIP.C and PAGEFL1RH, resource file PAGEFLIP.RSC). 

• TWISTER. ARC Back again! This time, 
TW1STER.PRG is the canceled version of the Twister floppy- 
disk formatting program Irom last issue's Hard Disk Warfare 
by Dave Small and Dan Moore Check the Alert Box (right 
next to Dialog Box at the front of this issue) for details of the 



YOU'VE SEEN BASIC RUN. NOW WATCH IT FLY. 

Imagine a BASIC interpreter so fast, it leaves all others at a standstill. 
An interpreter that's faster than most compilers. A BASIC interpreter that 
rivals the performance of compiled C. Imagine shifting to assembly language 
without ever leaving BASIC. At CCL, we did. 

The breakthrough is REAL BASIC. 

Start by writing and running programs using the power of a real 
interpretive environment. Trouble-shooting is a cinch with the advanced 
interactive debugging features of REAL BASIC from CCL. 

If your application demands the ultimate in speed and flexibility, don't 
panic. REAL BASIC understands 68000 assembly language. You can even access 
BASIC variables from within assembly code. 

CCL crossware is working with you. Just sit back and watch REAL BASIC fly. 
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TIMEWORKS' 

POWERFUL BUSINESS TRIO 

AN IN-DEPTH LOOK AT 

WORD WRITER ST, 

DATA MANAGER ST AND 

SWIFTCALC ST 



BY MATT LOVELESS 

CONSULTING EDITOR 



A ■ software collection is complete without the three sta- 
ff If pies of modern-day computing-a word processor for 
■ W creating documents, a database for maintaining lists, and 
a spreadsheet for working with numbers. Timeworks has en- 
tered the ST market with one of each -Word Writer ST, Data 
Manager ST, and SwiftCalc ST-and they've hit the ground 
running. 

Each of the three programs is sold separately, and they 
work well as stand-alone programs; if you don't need a 
spreadsheet, your Timeworks database or word processor will 
function fine by itself. But these products were designed as a 
package: you can integrate much of the data from one pro- 
gram into another For example, a small business could use 
Data Manager ST to keep track or data (clients, inventory, pay- 
ables, and receivables), SwiftCalc ST's spreadsheet for 
sophisticated fiscal reporting and forecasting, and Word 
Writer ST to combine numbers with text in a sharp-looking 
business plan to send to potential investors. 

Though you can move data between the three programs, 
it's nothing like the integration in a package like Framework 
for the IBM PC. Still, it's an added bonus if you buy more 
than one of the Timeworks products. The performance of the 
programs themselves, combined with Timeworks' support, 
upgrades, and an amazing satisfaction guarantee, make these 
three packages first rate. 

GENERAL NOTES 

Word Writer ST, Data Manager ST, and SwiftCalc ST each 
come enclosed in a three-ring binder and plastic slipcase. The 




documentation is typeset with a table of contents, index, glos- 
sary, and quick reference section; the Word Writer ST manual 
also has tabbed separators to help you find major sections 
quickly. The documentation begins by stepping you through 
running the program and formatting blank disks-a new ST 
owner could probably begin working with these programs 
within an hour or hooking up the machine. 

As an experienced user, I found I could use 90 percent of 
Word Writer ST without consulting the documentation; Data ► 
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In a last ditch effort to save the evening, we ordered drinks an 
strayed ever to the far edge of the SslsM bar. This turned out 
he a fortuitous now, indeed, Before loog, Kclleyj had struck up 
conversation with us, naking light of his ni 1 itary haircut and o 
ZESM education, while Carol tutored us on the fine art of su 
rolling. We staged the entire evening. Needless to sag, we had a 
fantastic tine. 

This is the first tine I haw been so pleased with restaurant 
service to write a letter, Kelley and Carol are hard working, 
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Figure 1: Word Writer ST 



Figure 2: Data Manager ST in colu 



Manager ST required a brief look at the tutorial and some 
time looking things up; and I had to read most of the Swift- 
Calc ST manual before getting started. To some extent this 
reflects the relative complexity ol the three programs. The 
main functions of the programs are well-documented in a 
friendly, easy-to-read style, but 1 found some egregious omis- 
sions in the manuals-there was virtually no documentation 
on Super Graphics (included with Data Manager ST and 
SwiftCalc ST), and Sideways (included with SwiftCalc ST). 

All three programs use GEM and include extensive online 
help; the help screens are usually called up by selecting an 
item under the HELP! drop-down menu. Word Writer ST and 
Data Manager ST use a scrolling center-screen help window 
that you can page through as you please. SwiftCalc ST's help 
window takes over the whole screen, which is slow and cum- 
bersome. It's context-sensitive, though: if you are in the mid- 
dle of a complex command and you press the Help key, the 
help screen will describe your current options. The program 
is fairly good at recognizing what you're looking for, but 
sometimes it will miss and bring up an irrelevant screen. 
With all three programs, you can delete the help screens 
when you no longer need them, thereby freeing up valuable 
disk space. 

WORD WRITER ST 

Word Writer ST, the word processor, looks and acts very 
much like 1ST Word, the first ST GEM-based word processor, 
which was distributed by Atari with all ST computers until 
sometime last year. 1ST Word is probably the most popular 
word processor for the ST, Timeworks took 1ST Word's basic 
design and expanded it, improving the user interface and ad- 
ding a 90,000 word spelling checker and built-in outline 
processor Like 1ST Word, Word Writer ST is strictly for text 
documents and cannot mix text and graphics. The two pro- 
grams can use each other's files. 



THE BASIC LOOK AND FEEL 

When you open a Word Writer ST document, it comes up in 
a large GEM window. The window shows the document's 
name, the current cursor position, tab stops, margins, text 
mode, and page breaks; you can scroll through your docu- 
ment using the scroll arrows and slider bars. 

At the bottom edge of the screen the program displays the 
meaning ol the function keys (which Timeworks calls Quick 
Keys), you can select a function by pressing the appropriate 
key or clicking on the display button. Resizing the window 
reveals another 22 Quick Keys (see Figure 1), which also have 
keyboard equivalents; some perform functions available from 
the drop-down menus. This means you don't waste much 
time switching from keyboard to mouse and vice versa-and 
if you ever forget a keyboard command, it's there on your 
screen. 

BUILDING DOCUMENTS 

Word Writer ST is a What You See Is What You Get word 
processor, a fancy way of saying whatever appears on the 
screen is pretty much what will appear on the printout. 
Italics, underlining, light, and boldface show up on the 
screen, and if your printer supports them, they'll be in your 
document, too. Word Writer ST does not directly support 
condensed or enlarged print, but you can embed printer 
commands in your document to take advantage of those fea- 
tures of your printer. To start typing in italics, for example, you 
press [Alternatel-iU or click on the italics button on the 
screen; to turn italics off, press (Alternate]-!!) again The cur- 
rent text mode is shown in the upper left corner of the win- 
dow and you can return to normal text in one keystroke by 
pressing lEscl. 

To change a large block of text from, say, boldface to light, 
you can select the beginning and end of the block either with 
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Figure 3: Data Manager ST in form mode 



the IF91 key or by dragging the cursor. Once a block is 
defined it's highlighted on the screen, and you can change its 
text mode by pressing keys or clicking buttons. 

Word Writer ST also has a feature that lets you automati- 
cally indent the lelt margin ol an entire paragraph by pressing 
the [F71 key. Each time you press it, the margin is moved in to 
the next tab stop. It's a nice feature for making lists, points, 
and tables, and the program remembers the indentation if 
you reformat the paragraph. (If you also want to indent the 
right margin-say, for a quote-you must change the margin in 
the margin line at the top of the window.) 

THE GOOD OL' [FIO] KEY 

Like any good word processor. Word Writer ST handles word 
wrap automatically when you type in a document. Like 1ST 
Word, though, it does not dynamically reformat your para- 
graphs; if you insert or delete text in the middle of a para- 
graph, the text can become fragmented. You can reformat the 
paragraph by pressing the [F101 key. 

The advantage is that Word Writer ST won't make changes 
in the way your document looks until you tell it to; if you 
want a chart to be unevenly spaced, that's just what you'll get. 
The disadvantage is that, if you have changed the line spacing 
or the right margin and then reformat a paragraph, the pro- 
gram uses the current settings rather than those you used to 
format the paragraph. This can be a real drag if your docu- 
ment has lots of complex formatting, such as indentation and 
changes from single to double spacing. 1 often want to print 
out double-spaced drafts for editing and then make my final 
document single-spaced; with Word Writer ST 1 have to type 
my document double spaced and then relormat it entirely for 
the final printout. Timeworks isn't alone in these short- 
comings, but it's something you should consider before 
buying. 

To their credit, Timeworks adds a menu selection that lets 
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you reformat an entire document with one mouse click. Of 
course, the special paragraph format problem still applies be- 
cause Word Writer ST will format ever)' paragraph to the cur- 
rent settings. 

EDITING TEXT 

The text editor is just acceptably fast. I can type faster than it 
can display, and so can anyone who can type over 30 words 
per minute. The keystrokes are buffered, though, so nothing is 
lost. 

Word Writer ST sports a range of basic editing keystrokes: 
insert or typeover; go to beginning of line, end of line, top of 
window, bottom of window, top of document, or bottom of 
document; delete line, word, or to end of line; and center a 
line. There are some keystrokes I really miss, like toggle up- 
per/lower case, but the major bases are covered. 

You can have up to four documents open at once, each in 
its own window, and you can cut and paste between them. 
Word Writer ST supports such block operations as cut, paste, 
delete, copy, and move. You can even quickly move to the top 
or bottom of a block. There are both search and replace func- 
tions, but the search is merely a text search; you can't use it to 
find or replace formatting codes like carriage returns. 

Word Writer ST allows you to edit straight ASCII files (text 
files without any formatting codes), and you can easily merge 
two files into one long one. There is also a handy status fea- 
ture that quickly tells you the number of pages, lines, words, 
and characters in your document, in addition to the remain- 
ing Iree memory. 

THEOUTLINER 

Included in the Word Writer ST program is a bare-bones out- 
liner. When you select Open Outline Form from the drop- 
down menu, a new window will open up as an outline. An 
outline window is like a document window except that it has 
special indentation leatures, allowing you to manipulate an 
outline with up to five levels of hierarchy. The word process- 
ing editing keys lunction while you're in outline mode; 
you have access to some special functions that let 
you build and rearrange outline headings. It is very easy to 
confuse the outliner when you are editing headings; keys- 
trokes don't always perform the way you expect them to per- 
form and your outline can easily get out of sync with the out- 
liner I found it frustrating to use and not really worth the 
trouble. 

THE SPELLING CHECKER 

Word Writer ST has a 90,000 word spelling checker built into 
the program. To use it, the program must load the dictionary 
into memory; it's about 128K in 26 files (one file for each let- 
ter of the alphabet). This takes quite a while to load from 
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floppies and significantly reduces your free memory. If you 
have 512K of memory, you will only be able to spellcheck 
about ten pages at a time; you'll have to break your document 
up into ten-page segments. On a one megabyte machine, 
memory for the spelling checker isn't so much a problem. 

The spelling checker runs in three modes: continuous 
spellcheck, spellcheck on key, and spellcheck document. The 
continuous spellcheck option checks your spelling as you 
type; if it finds a word it thinks is misspelled, it will alert you 
right away. The spellcheck on key option lets you check the 
word you just typed or the word under the cursor. The spell- 
check document option scans your entire document at once, 
looking lor misspelled words 

The dictionary is big enough to be lairly useful, but unfor- 
tunately, it's not expandable. When it catches a misspelled 
word it presents you with a number of similarly spelled 
words and you can either choose the correct word with the 
mouse or type in the correct spelling. If the spelling checker 
flags a word that is spelled correctly but not in its dictionary, 
you can click on the OK button and it will enter the word in 
its RAM dictionary and not flag it again until you exit Word 
Writer ST, so proper names and obscure words only get 
flagged once. 

PRINTING DOCUMENTS 

For printing your document, you can set header and footer 
lines, page number position, and starting number of the first 
page, in addition to the top margin, bottom margin, and page 
size. You can opt to print only a selected range ol pages and 
you can print multiple copies. You can even select "book 
printout," which alternates the margins for left and right 
pages, as in a book. 

Word Writer ST spools your printer output: it first prints 
your document to disk, which takes only a short time, then it 
allows you to go back and edit the current document or an- 
other document. While you're editing, Word Writer is simul- 
taneously reading the printed file from the disk and sending 
it to your printer, so you don't have to wait around for your 
printer to finish. This does pose a problem if your disk is 
nearly full; Fortunately, you can delete files directly from the 
File drop-down menu until enough space is freed up. You can 
also insert another disk with more free space. 

Drivers for most major printers are included, and Word 
Writer ST comes with a very easy-to-use configure program 
. that lets you build your own printer drivers. There's even a 
really nice chapter in the manual entitled "Unravelling the 
Mystery of Your Printer." 

INTEGRATION 

Word Writer ST's integration with Data Manager ST and Swift- 
Calc ST is rather unsophisticated: it simply reads in a text file. 
This lets you include tables, reports, and other data in your 
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documents, but it does not allow an automated mail-merge, 
lor example. 

CONCLUSION 

Word Writer ST is a very good general -purpose word 
processor- certainly one of the best. Experienced word- 
processor users may feel encumbered by the mouse interface 
and the speed limitations imposed by GEM, but it's very 
much an improvement upon 1ST Word. It is simple to use 
and fairly powerful, and has some nice extras that mark it as 
a professional product. There are a lew minor bugs and some 
very real limitations, though, like the unexpandable dic- 
tionary. 

According to Timeworks, Word Writer ST is currently 
under revision and a new version will be out soon. Consider- 
ing their liberal upgrade policy (see below), it wouldn't be a 
mistake to purchase it now. If you are new to word processing 
and want a solid, uncomplicated program, this is a sterling 
buy 

Personally, 1 use only two word processors: ST Writer and 
Word Writer ST. I use ST Writer for long documents that don't 
require sophisticated formatting; it's last and makes major 
editing a simple job. 1 use Word Writer ST for short letters 
and notes (less than five pages) because it is so easy to get the 
document to look exactly like 1 want it to; to do that in ST 
Writer would require two or three trial printouts and a lot of 
parameter tweaking (Editor's note: ST Writer is a word proces- 
sor distributed free 0/ charge by Atari Corp. It is available on many 
online services, such as CompuServe and GEnie, and from user 
groups. ST Writer version 1.50 is part of the Winter 1986 START 
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DATA MANAGER ST 

Data Manager ST is the jewel among the three Timeworks 
products-an extremely well written, carefully polished non- 
relational database that includes a healthy assortment of 
fields (text, numeric, and calculated), suitable for keeping 
track of anything from a Christmas mailing list to a small 
company's invoices. Like Word Writer ST, Data Manager is not 
designed to be ultra -powerful; instead, Timeworks has hit 
upon the perfect trade-off between power and ease of use. It's 
a pleasure to work with Data Manager ST. 

THE BASIC LOOK AND FEEL 

Data Manager ST works with and displays data in two basic 
modes: column and form. Column mode places your whole 
database inside a spreadsheet-like window, with your held 
names across the top of each column and every record on its 
own row (see Figure 2). This gives you an "overhead" view of 
your data. You can instantly jump into form view by selecting 
form mode, which shows you one record in your current 
database (see Figure 3). You can move forward and backward 
through your database at the press of a key or the click ol the 
mouse, and edit a record or enter a new record at any time. 
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The form and column displays support and complement 
each other in a superbly intuitive manner. You can manipu- 
late your entire database at the surface level in the column 
mode, and change individual records in the form mode. Vir- 
tually even' major command is available from both modes 
and you can switch modes at will. 



CREATING AND MODIFYING A FORM 

Creating or modifying a form is simplicity itself. In creating a 
new field the program leads you through a series of dialog 
boxes where you specify the field's name and format. Basic- 
held formats available are text (letters and numbers), alpha- 
betic (letters only), numeric, Yes/No, calculated, form title, 
time, and date; you can also specify a custom format. 

For numeric fields, you can specify how the data should 
appear (leading dollar signs, number or places after decimal 
point, etc.). With a custom format field, you specify the exact 
type of text allowed in the field. For example, say your com- 
pany's purchase orders always begin with two uppercase let- 
ters, followed by 5 numbers, followed by a tower case letter; 
you could design a field so you could enter only data that 
matched this format. 

Calculated fields are the most powerful. You could calcu- 
late your profit, for example, by subtracting the cost column 
from the price column. With IF, THEN, and ELSE lines, you 
can perform conditional calculations; for example, a field 
could calculate a 10% discount if an order is for $5,000 or 
more, but give no discount if the order is less than $5,000. 

Once you have created a field, you can immediately begin 
entering intormation into it. You can move a field to a new lo- 
cation on the column display by selecting it and choosing the 
move column command; on the form display you can drag it 
with the mouse. You can also make the size of the field larger 
or smaller just by dragging the field's rectangle to a different 
size. 

ENTERING AND EDITING DATA 

You enter and edit data into your database from the form 
mode, which acts like a giant dialog box. You can move from 
field to field with the arrow keys or the mouse, and you can 
clear a field with the Escape key. There's not much to learn; 
you just enter your data. Data Manager ST will alert you if 
something goes wrong. You can easily move from record to 
record, editing as you go, or you can jump directly to the last 
record (which is blank) to make an completely new entry. 

If you're in column mode and want to examine or edit an 
entry, simply double-click on the item. You will be transferred 
to form mode instantly and that record will be called up. En- 
tering and editing are virtually instantaneous, since Data Man- 
ager keeps the entire database in memory. 

VIEWING 

You view your entire database in the column mode. Unless 
you have limited your view or hidden columns, the column 
mode will display all the information currently in your data- 
base. The key to extracting specific information in your data- 
base is selectively limiting, or sharpening, the column view 
until just the information you desire appears in the window. ► 
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The first method for limiting your view is to hide columns. 
Once you've hidden a column, it won't show up in the 
column view until you reveal it again. The information won't 
be displayed and won't print out, but any calculated columns 
will have access to the hidden column's information. 

Once you have hidden unwanted columns, you can begin 
focusing and organizing specific data by using sorts and 
searches. For example, say I have created an accounting data- 
base for my business and 1 want to send out a bill to all the 
companies with names beginning with A through L that owe 
me more than $500. The first thing 1 would do is select View 
by Range and tell it 1 want all the records in which the data in 
the Company Name field falls in the range of A to L. Data 
Manager ST will search through my database and temporarily 
hide all the records that don't fall in that range. Now I have 
the A through L companies. 

I then choose View by Specification, such that the data in 
the Total Receivables column is greater than $500. Data Man- 
ager ST will further limit my database, hiding all companies 
that owe me less than $500. Now I can sort them by the date 
the payment was due (placing the most delinquent payments 
at the top) and print out a list for the collections department. 

This concept of successively narrowing your view of the 
records lets you make your record selection as complicated 
and as specific as you want. Most databases require that you 
enter all the limiting criteria at once and require that you use 
non-intuitive Boolean operators (such as AND, OR, and 
NOT). Data Manager ST eliminates all this confusion by giving 
you free rein and allowing you to zoom in on your data as il it 
were all on 3-by-5 cards rather than in a computer's memory. 

PRINTING FORMS, LABELS, AND REPORTS 

The simplest type of printout is the form printout; it simply 
prints all the records and columns that aren't hidden. By hid- 
ing columns, moving columns, and using view by range and 
specification, you can customize the printout. You can also 
set printout parameters like margins, paper size, and any spe- 
cial printer codes. 

Printing labels is like printing forms, except that the data is 
printed in standard label format. This way you could make a 
mailing list automatically or make l.D. tags for your office 
equipment. The records and fields you want printed are 
limited in the same way as a form printout. 

The report writing feature is the most sophisticated type ol 
printout. Like forms and labels, you can first limit the records 
and fields you'll use, but you also have the option of multiple 
and hierarchical subtotals and running totals. You may also 
place up to six lines of header and footer information on each 
page and set the page size, margins, and printer codes. See 
Figure 4 for an example of a report generated with Data Man- 
ager ST. The report writing feature handles its task fairly well. 
Unlike many databases, it is very simple to specify the report 



format and get instant, good-looking reports. However, tor this 
simplicity you sacrifice flexibility. 

INTEGRATION 

Data Manager ST creates different types ol data files for Word 
Writer ST and SwiftCalc ST. The SwiftCalc-type file is essen- 
tially a form printout written to disk in the D1F format; this 
can be used to pass text and numbers to a SwiftCalc spread- 
sheet. The Word Writer output is exactly like a printed report 
output, except the information is written to a Word Writer file 
rather than sent to the printer Data Manager ST will not im- 
port any information directly. 
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THE SUPER GRAPHICS PROGRAM 

Included with Data Manager ST and SwiftCalc ST is the Super 
Graphics program. Super Graphics is a wonderfully powerful 
graphing program; Timeworks could probably sell it for $40 
if they wanted to-it's that good. Instead, they decided to in- 
clude it with Data Manager and SwiftCalc. 

Super Graphics supports horizontal and vertical bar charts 
and line and scientific graphs. There are also various types ol 
each graph-a total of 15 ways to display your data. Some of 
the more interesting modes include stock charts (with highs 
and lows), Gannt charts (for project planning), and summed 
line charts. 

To use the Super Graphics program with Data Manager ST, 
you first manipulate your database so only the information 
you want to use is displayed, then save it in a special graph 
file format. Then you leave Data Manager ST and enter the Su- 
per Graphics program; once there, you import your data, 
selecting rows and columns of labels or numbers. Once the 
data is in Super Graphics format, you can display it using any 
of the various graph types. Additionally, you can add legends, 
headers, footers, and change the colors and fill patterns of 
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yourgraph-you can adjust the graphs appearance quite a bit. 

The graph is initially displayed on the computer screen, 
but once it's the way you like it, you can output it to a printer 
or plotter Unfortunately (and this is the program's major flaw) 
Super Graphics only supports lour types of printers, all made 
by Epson (the MX, FX, RX, and LQ series) and three types of 
plotters (Epson Hi-80, Com Scriber, and Sweet-P)-but not 
such plotters as the industry-standard Hewlett-Packard 
74/75A. Admittedly, it's difficult to develop virtual-device 
printer drivers, but unless you own one of these printers or 
plotters (or a compatible), the uselulness of the Super 
Graphics program drops considerably. 1 was only able to try 
the printer output and I found it very acceptable (see Figure 
5.). You can print in high or low resolution on 8'/2- or 14- 
inch-wide paper. 

Super Graphics is a very nice program. Importing data can 
be confusing, though, and the documentation is extremely 
sparse, doing little more than describe the types of graphs 
available. I had to spend more than 15 hours experimenting 
before I could get my graphs to appear as 1 wanted them. 

CONCLUSION 

Data Manager ST is a marvelous piece of craftsmanship. It is 
my favorite of the Timeworks programs and I can see using it 
for a very long time. Hands down, it's the best non-relational 
database lor the ST computers and one of the best 1 have seen 
for airy computer. Data Manager ST is simple to use, with a 
delightful user interface and a lairly powerful set of searching, 
sorting, calculating, and output abilitites. It is not, however, a 
data-cruncher; if you're looking to manipulate massive 
amounts of strange data, you should investigate some of the 
other database programs available (See Brian Lee's "ST Data- 
base Management Systems," START, Spring 1987, #4.) 



SWIFTCALCST 

SwiftCalc ST is a spreadsheet program -a giant sheet of elec- 
tronic accounting paper (see Figure 6). Each cell in a spread- 
sheet can hold text, a number, or a formula. A text cell is 
usually used for identifying a portion of a spreadsheet- for 
example, "Yearly Sales," "Total," or "January Expenses." A 
number cell simply holds a number that is used in the calcu- 
lations. A formula cell is the real meat: it relates number cells 
and other formula cells using a mathematical formula; for ex- 
ample, the cell that calculates profit might be set to price mi- 
nus cost. A spreadsheet can be used for anything from cal- 
culating your taxes to forecasting your net worth. 

THE BASIC LOOK AND FEEL 

OK-the bad news first. 

SwiftCalc ST has the guts of a decent keyboard-controlled 
spreadsheet, much like VisiCalc or Lotus 1-2-3 -except, in 
what appears to be a last-minute effort, Timeworks has added 
a GEM front to it. Now it looks like a keyboard-controlled 
spreadsheet inside a window. Not a good sign. 

This incomplete and unholy marriage between GEM and 
keyboard has some basic design flaws. First, SwiftCalc ST is 
far too slow in updating the screen. (That's actually a bit 
ironic when you consider the name of the product.) For ex- 
ample, when you move the cursor off the edge of the screen 
and the spreadsheet scrolls, it takes over a second to scroll one 
cell position vertically. That's ten seconds to move down ten 
cells— slightly less than eternity, but when you're sitting there 
watching it happen, it's excruciating. There are some tricks to 
speed up movement, but 1 found none of them very satis- 
factory. ' 



Figure 5: Graph created with Super Graphic 
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Timeworks. . . 

Second, the user interface needs some work. You select 
functions through a bizarre and inconsistent hybrid of mouse 
and keyboard input. Sometimes you point and click with the 
mouse and sometimes you use the keyboard. It is definitely 
not intuitive. If you restrict yourself to using the keyboard 
commands entirely, it's just like operating a fairly decent non- 
GEM spreadsheet. It's as if GEM had been added as an after- 
thought. Using SwiftCalc ST is not only confusing and frus- 
trating, it's plain inefficient. 

Lest I seem unfairly critical of SwiftCalc ST, let me say that 
1 really want to like this product. Six months ago, this half- 
GEM stuff would have been par for the course. Since then, 
though, spreadsheet user- interfaces have matured (most nota- 
bly with the release of the GEM version of V.LR Professional). 
Timeworks has even set their own standard of excellence with 
Word Writer ST and Data Manager ST. Compared to them, 
SwiftCalc ST just doesn't measure up. As you will see, it is 
otherwise a fairly robust spreadsheet. Another two months oi 
thoughtful development and testing probably would have 
paid off in the long run. 

WORKING WITH SWIFTCALC 

When SwiftCalc ST first loads, it starts you out with a blank 
spreadsheet. You can immediately start building a new 
spreadsheet or load one off disk. Across the top of the screen 
is the SwiftCalc menu bar and in the open window on the 
screen is your spreadsheet. You can move around your 
spreadsheet with the cursor keys, the scroll bars, and the 
"goto" command. You can also select any cell within the cur- 
rent window with the mouse. A line at the bottom of the win- 
dow displays the contents of the current cell— a very helpful 
feature. SwiftCalc supports up to 8,192 rows and 256 
columns- that's much larger than you should ever need. 

Most commands can be initiated from the GEM menu bar. 
However, many of them, once chosen, require some sort of 
secondary action with the keyboard. Ideally, these would 
have been handled by dialog boxes, but instead you are con- 
fronted with text choices at the bottom of the window and 
you must take your hands off the mouse and respond on the 
keyboard. This results in frequent jumps from mouse to key- 
board to mouse. Some of the more esoteric commands cannot 
even be accessed from the drop-down menus; you need to 
get at them entirely from the keybaord. The more popular 
commands, such as recalculate and insert column, are as- 
signed to the function keys, and many menu items have 
Quick Key equivalents (where you press [Alternate! plus some 
letter key). However, this only manages to confuse things: Do 1 
press IAltl-101 or type /L to load a file? Also, unlike Word 
Writer ST or Data Manager ST, there are no Quick Key buttons 
at the bottom of the screen. Fortunately, the help function is 
context sensitive and will more often than not pull up useful 
information when you're stuck. 



CALCULATION FACILITIES 

SwiftCalc ST will accept cell formulas up to a maximum of 69 
characters in length. In addition to the standard mathematical 
functions (addition, subtraction, etc.), SwiftCalc also includes 
roots and powers, natural logarithms and common 
logarithms, degrees-to-radians and radians-to-degrees, cosine, 
sine, and tangent, and their inverses, and constants such as pi 
and c. 

SwiftCalc ST will also operate on ranges of cells and allow 
you to find the minimum value, maximum value, average 
value, sum, and number of values in the range (not counting 
blank or text cells). Also included are the cornerstones for 
financial analysis: compute present value of a dollar, compute 
future value oi a dollar, compute present value of an annuity, 
and compute the future value of an annuity. 

Eor calculations requiring some sort of table data, there are 
CI IOOSE and LOOKUP The CHOOSE function is an array 
lookup table; if you pass it a 13, it will give you the value of 
the 13th cell in a specified range. The LOOKUP iunction will 
search through the cells in a specified range, looking for a 
number greater than the number you pass to it; when it finds 
such a number, it returns the value from an adjacent cell. 
Range lookups are crucial for tax spreadsheets and other 
similar table-heavy calculations. 

SwiftCalc ST supports an if. . .then type construct, allow- 
ing a cell to evaluate to one value if the expression is true and 
to another if it is false. You can use the standard comparators 
(< >. < = , etc.) in your expressions, along with the logical 
operators AND and OR. 

OTHER FEATURES 

Most spreadsheets allow you to set the format of the cell, 
which determines how the data will be displayed (for exam- 
ple, right-justified, left-justified, or centered, using dollar signs 
or commas, etc.). A unique variation on the basic formats that 
SwiftCalc supports is the scale factor, a number between 
and 9 that scales the value printed in the cell down by 10 
raised to the scale power. This allows you express financial 
statements in millions or the national debt in trillions. Swift- 
Calc ST, however, only allows you to use and define eight 
different formats; most spreadsheets let you define as many 
as you want. 

SwiftCalc ST only allows one file to be loaded at once, but 
you can split your screen into two separate windows on the 
same spreadsheet. The two windows can be set to scroll to- 
gether or separately. By opening two windows, you can enter 
data at one end of your spreadsheet and watch results at the 
other. 

You can do multilevel ascending and descending sorts on 
your spreadsheet; you can assign names to individual cells; 
and you can copy, move, and delete blocks. There is even an 
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intelligent" copy and delete called data query, which 
searches a range and extracts the information you specify and 
either deletes it or copies it to another part of the spread- 
sheet. You can also use the data fill option to fill a range of 
cells with a range of values. Or you can generate a table of 
values by specifying a formula to calculate the values; Swift- 
Calc will stuff them into the range automatically to build the 
table. 

One of the most powerful features of SwiltCalc ST is the 
join function. Join allows you to pull in values from other 
spreadsheets on your disk. You pick a destination cell in your 
current spreadsheet and choose join; it prompts you for a 
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Figure 6: SwiftCalc ST 

filename and a cell location in that file. Once you've set up 
these links in your spreadsheet, whenever you recalculate 
SwifcCalc ST will pull the values off of the disk files and enter 
them into the linked cells. The links are saved along with 
your spreadsheets. This lets you create massive, intercon- 
nected spreadsheets. 

INTEGRATION 

SwiftCalc ST will import (and export) DIP files. D1F is a stan- 
dardized spreadsheet output format that holds the labels and 
values in cells but not the formulas. DIF capability makes 
SwiftCalc ST data compatible with DataManager ST and other 
spreadsheets which also use this format. You can also "print" 
your spreadsheet to disk in Word Writer ST format so you 
can merge your data with your text. 

SwiftCalc also includes the Super Graphics program, and it 
works very well as a data generator, allowing you to take lull 
advantage of the various graphs. 

PRINTING SPREADSHEETS 

There are two ways of printing your spreadsheet. You can 
print it normally from within the spreadsheet, which prints 
the columns across the top of the page and rows downward. 



This limits you to 80 characters of columns with a normal 
carriage printer, unless you switch into condensed mode, i 
was unable to send my printer the correct commands be- 
cause the printer setup feature wouldn't let me send an escape 
code. (Timeworks customer support acknowledged this 
problem.) 

The second way of printing your spreadsheet is with the 
Sideways program included on the SwiftCalc disk. Sideways is 
a program from Funk Software that lets you print your 
spreadsheets sideways, so you can use as many columns as 
you want (having it print across multiple sheets of fanfold pa- 
per). Most spreadsheets are wider than they are long, so this 
is a very useful utility. The Sideways program works very well, 
although it is slow. It supports more than 15 of the most 
popular dot-matrix printers, and will print your spreadsheet 
out horizontally in a choice of font styles, ranging from 
minuscule to mammoth. 

CONCLUSION 

SwiftCalc ST is a powerful enough program for most people, 
though it is missing some the common spreadsheet features, 
such as macros. Its fatal flaw, however, is its user interface, 
which is inconsistent and clumsy. If you are interested in the 
spreadsheet to complete your Timeworks package, weigh your 
options carefully: any spreadsheet that can load DIF files 
should be able to read Data Manager ST files written out in 
SwiftCalc ST format, and if the spreadsheet can print to disk 
(most can) you can load it into Word Writer ST as an ASCII 
file and merge it with your document. In its present state, 1 
wouldn't buy SwiltCalc, except maybe to get the graphing pro- 
gram if 1 didn't already have Data Manager ST. With the 
GEM/keyboard schizophrenia removed and the speed prob- 
lem resolved, it would be a valuable and useful program. I do 
believe that Timeworks realizes the deficiences in the current 
version and will plan a major revision sometime this year 

PRODUCT PHILOSOPHY: 
THE BEST IN THE BUSINESS 

When you buy a Timeworks product, you don't just get a 
disk, a manual, and a shove out the door; you buy into a 
whole network of support and ideology 

First, they have an amazing guarantee: if, within 90 days of 
your purchase, you can find a competing product that works 
better for you, simply send in your Word Writer ST, Data 
Manager ST, or SwiftCalc ST, along with the name of the prod- 
uct you want and any retail price difference. Timeworks will 
actually buy the product for you. You almost can't go wrong 
buying a Timeworks product; if you don't like it, send it in for 
something new. A guarantee like that takes confidence. 

And there's another show of confidence: Timeworks does 
not copy-protect their software, so you can make as many 
backup copies as you want for your own use, and painlessly ► 
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Timeworks. . . 

install the programs onto a hard disk. I hope Timeworks 
won't get burned by rampant software piracy. 

Timeworks maintains a toll-free customer support helpline 
for registered owners of their products. It's open weekdays, 9 
to 5 Central time. 1 found the customer support team to be 
friendly and helpful; they were very familiar with their prod- 
ucts and manuals and able to answer my questions quickly. 

UPGRADES 

Timeworks recognizes two types of upgrades: product up- 
grades and equipment upgrades. The product upgrades are 
pretty standard. Timeworks tries to revise each of their prod- 
ucts at least once a year; when they do, each registered owner 
will get a mailing describing the upgrade (added ieatures and 
fixed bugs), including instructions on how to get it. Usually 
there is a small upgrade charge that is proportional to the 
significance of the revision. For example, a simple bug revi- 
sion would cost you the price of a disk plus a modest postage 
and handling charge, whereas a full upgrade, where significant 
enhancements have been made to the program, might cost 
you $20. 



Equipment upgrades are a bit more interesting. If you buy 
a Timeworks program and then buy a different computer, you 
can get any Timeworks product for your new computer by 
sending in your old program along with S7.70 plus the retail 
price difference. This isn't that significant a benefit for ST 
owners-we already know the next generation from Atari (die 
Mega ST) will be upwardly compatible with the current 
machines. But say you own a Commodore 128 and a couple 
of Timeworks products. If you buy an ST, you can get the ST 
versions of your software at a very small cost. 

HOW IT ALL ADDS UP 

Word Writer ST, Data Manager ST, and SwiftCalc ST are all 
straightforward entry-level products. They aren't designed for 
power users, but they arc Fairly powerful and easy to use. 
Word Writer ST and Data Manager ST set standards for 
price/performance and ease of use. SwiftCalc ST is not a bad 
program, but it's not nearly as polished as the other two- 
investigate its competition before buying. 

With Timeworks support and guarantee and the power of 
Word Writer ST and Data Manager ST-and the likelihood 
that SwiftCalc ST will improve soon -I look forward to more 
high-quality products Irom Timeworks. ■ 
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ST 
BACKUP 
UTILITY 

You can't backup your software 
because copy protection locks 
you out. ProCopy is the key! 

■ Protects against the accidental loss of 
expensive software 

■ Works with all Atari STs 

■ Copies both S/S & D/S disks 

■ Use with 1 or 2 disk drives 

■ Not copy protected 

■ FREE shipping and handling 

■ TOLL-FREE telephone number 

■ Updates are only SI 2 with return 

■ Orders shipped same day 

■ Disk analyze function included 
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Call (800) 843-1223 

Send check (or S34.95 (overseas add S2.00 tor air mail) to: 
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<401) 568-8459 
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and 
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Southampton, SOl- 
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TECH-SOFT 

COMPUTER WHOLESALE 

324 Stirling Highway 

Claremonf 

Western Australia 6010 

Tel. 09-365-1885 



IF YOU'D LIKE TO SEE MORE ARTICLES LIKE THIS ONE. 
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Word Writer ST version 1.00 
$79.95 
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Data Manager ST version 1.1 
(includes Super Graphics) 
$79.95 
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SwiftCalc ST version 1.0 

(includes Super Graphics and Sideways) 

$79.95 
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444 Lake Cook Road 
Deerfield, IL 60015 
(312) 948-9200 
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Commodore 64 Atari ST 



GRANDSTAFF version 



Conductor's Score 
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Sequencer 
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Educational Software 
tlie lAges 2 to 61 




INTRODUCING 

"ST ALPHA-BYTES"™ 

FROM CTJSSIQN SOFTS™ 

Gem' based educational software for the Atari ST" for children ages 
2to6years. Packed full of giggles and hours of fun. "ST ALPHA-BYTES" 
uses delightful graphics to introduce children to letters and words. 
Features: 
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"Don't even think about another C compiler" 




- Mike Fleischman, ANTIC: The Atari Resource, Sept. 1986 


Megamax Professional C Development System For The Atari ST 
Rated #1 C compiler by ANTIC, Computers Atari ST, and Start: Trie ST Quarterly 


• Full Kernighan and Ritchie implementation • In-line assembly and structure passing 

• Single pass compilation • Object file librarian 

■ Full access to GEM routines • Six times faster than Atari Development 

• Graphical shell Package 

■ Intelligent Linker produces efficient native code • Develop on single drive 520 ST 

• Extensive documentation 

• Disassembler • The compiler chosen for development by: 

• C programmer's editor Batteries Included 

• Code improver FTL Games 

• Developer support included Supra Corp. 

• Resource construction program $199.95 

■ Create desk accessories Mastercard, VISA, American 

Express & C.O.D. accepted 
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Megamax, Inc. * Box 851521 

Richardson, TX 75085 

(214)987-4931 
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Save Your 

Synthesizer 

Sounds 

MIDISAVE, a Casio and Yamaha patch librarian 



by TOM BAJORAS 



In our ongoing support for the ST and the world of music, 
we present MIDISAVE-a simple patch librarian that worlv, 
with most synthesizers, including the Casio series with its 
offbeat protocols. Join Tom Bajoras of Hybrid Arts as he un- 
ravels the intricacies of how synthesizers handle MIDI in- 
formation. You'll find Tom's MIDISAVE program on your 
START disk. 



Since its introduction in the summer of 1983, MIDI (the "Musical Instrument Digi- 
tal Interlace") has spread like a new religion throughout the music industry to the 
point where, in some trade magazines, the words "MIDI" and "music" are used in- 
terchangeably, A survey conducted recently by one of the leading music magazines reveals 
that 42% of its readers use personal computers in their music, and the other 58% plan 
to get computers sometime during the next year Traditionalists may shake their heads in 

iSMFHeMIDISAVE.ARC 
WMon your START disk 



dismay over this state of affairs, but one thing is certain: MIDI 
is here to stay. 

Until the Atari ST computers appeared, a musician who 
wanted to connect his or her computer to a synthesizer had 
to buy or build a MIDI interface and connect it to one of the 
computer's existing I/O ports. Practically all electronic musi- 
cal instruments-synthesizers, drum machines, sequencers, 
audio processing effects, and now even mixingboards-have 
a MIDI interface built into them. The ST is the first computer 
to have a built-in MIDI interface. This, combined with the ST's 
outstanding graphics and processor speed, is making the ST 
the focus of a lot of attention from music software developers. 

The success of MIDI can be attributed to its highly stan- 
dardized communication protocol. A document called the 
MIDI 1.0 Specification (or "MIDI Spec") serves as the bible for 
MIDI hardware and software engineers. I don't have space 
here to go into all the information in th 
MIDI Spec, but curious readers can 
get a copy of the spec from 
the International MIDI Asso 
ciation, 11857 Hartsook 
Street, North Hollywood, CA 
91607. (Editor's note: For more 
on the MIDI Spec, see Tom 
Jcjjiiess "The Ins, Outs and Thrus 
ojMDl," START 4, Spring 1987.) 

On your START disk you'll 
find MID1SAVE, a MIDI generic 
patch librarian written in 
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Alcyon C It works with many 
different brands of syn- 
thesizers, including all those 
that follow the MIDI 1.0 Spec, 
as well as the popular Casio 
synths that have their ^IN- 
own variation on the ^" 

MIDI protocol. To under- 
stand why it can't work with 
every sort of MIDI device, we'll 
have to examine how MIDI lets ^ 
different musical instruments 
talk to one another 

INSIDE MIDI 

MIDI transmits information in 
groups of bytes called messages. 
Each message consists of a sta- 
tus byte followed by a number 
i, of data bytes. The most 
-g significant bit (MSB) distin- 
3 guishes between status and 
| data bytes: If a byte's MSB is set 
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then the byte is a status byte, otherwise it is a data byte. Thus, 
status bytes range (in hexadecimal) from S80 to $FF, while 
data bytes range from $00 to S7F. There is an extensive 
vocabulary of status bytes, each having a certain number of 
data bytes that must follow it. For example, the status byte 
$90 means "Note On on MIDI channel 1." (Channels are 
MIDI'S way of addressing multiple instruments. Each instru- 
ment can be set to one of 16 channels. It will then only re- 
spond to the MIDI messages sent to it on the corresponding 
channel.) The $90 status byte requires two data bytes, so an 
entire Note On message looks like this: 

$90 KK VV 
The KK data byte is a key number, ranging from $00 to $7F, 
and the VV is a velocity value, also ranging from $00 to $7E 

The two status bytes of particular significance to MIDI- 
SAVE are $F0 and $F7, which stand for "System Exclusive" 
and "End of System Exclusive" ("EOX"), respectively. 
Early on in the history of MIDI, the Spec's 
designers realized that, although standardization 
is a wonderful thing, not all things can be stan- 
dardized. There is no problem sending note 
commands, controller commands, patch 
changes, and so on from one synthesizer to 
another, even if the two synthesizers are 
sj^ from two different manufacturers. But 
when it comes to communicating patch 
data— chat is, the data used by the syn- 
thesizer's sound-generating hardware and 
software to produce a specific sonic 
timbre-that's a different matter For ex- 
ample, a Yamaha DX7, a Casio CZ101, and 
an Oberheim Matrix-12 approach sound- 
making in three fundamentally different 
ways. It is not possible (and may never be 
possible) to exchange patch data between 
those instruments. 

Of course, it is possible to exchange 
patch data between two identical instru- 
ments, so the MIDI Spec had to be set up 
in such a way as to allow patch data to be 
sent over MIDI, while somehow prevent- 
ing a Yamaha from forcing its patch data 
down a Casio's throat or vice versa. That's 
where the System Exclusive and EOX 

us bytes come in. In fact, 

I. '.!.:!: ! !■.:..■ 

r S^ called "patch data" 
■ . . ,■ : ■ . i ! ■ i . . ■ ■.■■■. -;.'. 

;■■■ I icnr. is now 

w^ "System Exclusive data." 
Ppp?ft. >• The $F0 status byte tells 

the receiving instrument that ► 
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Your ST (with MIDI) 

+ K5MKMI 

= The MoST Fun! 



Your ST (with its MIDI port) is the door to 
a new musical language. And Keyboard 
Magazine is the key that will help you 
unlock your creative potential. 

Let Keyboard introduce you to MIDI 

(Musical Instrument Digital Interface) to 

allow you to transmit data from your 

synthesizer to your computer. So you 

can start using your system to make 

your own music. 



Keyboard gives you monthly columns on: 

computer applications for music, synthesizer and MIDI 

basics, how to master MIDI, and how to make music 

software work for you. Plus in-depth product reviews 

of the newest equipment and software. 

Make the fullest use of your ST and its MIDI 
capabilities. Start making music now! And save 44% 
off the cover price. Get 12 monthly issues of Keyboard 
for only $19.95. 



Yes, I want to make music and have fun with my ST and Keyboard. I 
want 12 monthly issues for only $19.95. Send to: Keyboard Maga- 
zine, 20085 Stevens Creek, Cupertino, CA 95014. 

Name . . 



D Payment enclosed 

Charge my □ VISA □ MasterCard □ Bill me 



Address _ 

City 

State 



Exp. Date_ 
Signature- 



Zip- 



esgood in U.S. only. C.i mi 1 1 1, in ii it! iiiri'iynjuriiii...' ]i„ I .lriri J 7 [.nv miI^ci ifitinn lor postage, 
■ign air mail (5-10 ckiv ■:i..- , !.-i.-r v: jorl SJi'Jui.Ti'.il.^.rjriy.ri' in fur |.u:-,',.(;l_\ All non-U.S. orders payable 
.S. dollars by International Money Orderonly. Allow 4-6 weeks (U.S. ) and 6-B weeks (Canadian 
foreign) ior delivery ol first issue. Offer good unril September 30, 19B7. 4180 
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A DIVISION OF MICRO PERIPHERALS, INC. 

P BOX 369 
ATARI KETTERING, OHIO 45409 ATARI" 



"A. 



I ST's Color or Mono 

toniior Cables...- 

J SF 3(4 Double Sided Orive 

ra 20, 30. 60 Meg Hard Disks .. . 
\ SHD 20*20 Megabyte Hard Disk ... 

I SC 1 224 RGB Color Mnnilor 

I ST -COVERS, Heavy Grade Vinyl 

I ST -MOUSE MAT 

I ST-6' PrinterCable 

] ST-ModemCable(loHayes.elc.}.. . 
Monitor Sland. Swivel & Till . . . 
j Disk Filelor 3.5"disks (holds 40) .. . 
. Power Strip. 6 oullel (15 amp Surge) . 
! Deluxe Power Strip w/ Spike & Surge 

1 PANASONIC PRINTERS 

1 EPSON PRINTERS 

I STAR PRINTERS 

1 CITIZEN PRINTERS 

1 HABA1200(HayesCompalible) . . 

| VOI.KSMODEM VM 520 . 

i AVATEXSmart1200bps . Spocla 

, AVATEX1200H.C 

PRIHTEP PAPER. Micro-Fine perls. 21 



; IS Talk 

— J !',!pe r chp Elite 

■ CALL T hu nder ... 

■■WLL TimeLink 

ELECTRONIC ARTS 



CALL B 

■ C ALL Chessmaster2 

. 3S E, 



j* Summer Games. 

'" .1 Winter Games . . 

" SuperCycle.. . 

'" ''° Cha~i;;!iii:-,lii|: '. ',■'■! 

j* US 6 ™" 

"^ Temple otApsh; 



EPYX 



INFOCOM 
MICHTRON 



■jjjg Business ioo 
9 g Cornerman . 



EE3HBH 

ATARI 



Mighly Mail 
Soft Spool . . . 
■ Personal Money Manat 



19 



ePawn . 



33 Regent Base . 
33 Regent Word II 
33 SIERRAON- 

■CALL ST ONE WRITE 

■ Cash Disbursements 
26 • Actounis Receivable 



29 Daia Manager ST 



.33 Swift Calc ST 



MathW 



UNICORN 



BATTERIES INCLUDED 



45 Fraction Action 

.36 Decimal Dungeon . . 
29 UNISON WORLD 

12 Prim Masler 

An Gallery I. II or III 
26 ST LANGUAGES 

20 M0DULA2 

12 • Developer's Kil 

MARK WILLIAMS C 
CALL LATTICE C 



M DEGA 


E ::: 


.CALL GST-ASM 






jj Prices Are Per Box of 10 DISKETTES 






3.5" MICHO-FLOPPIES 




X No. ol 


SONY/ MAXELL 


VERBATIM 


Bo<es 


SS/DD 


DS/DD 


SS/DD 


U 2-5 


15.00 


23 DC 


14 00 


X 6 " 10 


14.00 


22 00 


13 03 






!j TO ORDER, CALL TOLL FREE 

: 1-800-255-5835 





; ivi-r a am-9 pm • tbi • bAi iuam-4pm i 
mtM' Ohio Residents, Order Status or f~ 
VISA' Tech. Info Call (513) 294-6236 (** 
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JEW • NEW • NEW • NEW • NEW • NE 



USA VERSION AATARI ST ' 



ATARI ST CARTRIDGE 

A new and very fast BASIC I 
ccrTun:1»rs This 12BK progn 
computers and so makes lull use ot (and gi 



ROM cartridge tor the Atari ST 

" lecl'lcally tor the Atari ST 

programmer lull access It 



COMPARISONS 



PCW BENCHMARK 



7*- 



SPEED. With an average PCW benchmark speed ot 1.3 seconds, this Is the 

fastest BASIC available (taster lhan any other PCW have tested) and Is taster 

lhan BASIC running on Ihe new Compaq 80386 super micro. See table lor 

other comparisons. 

EDITOR. A lull GEM based scrolling editor is included. Supports search and 

replace, cut, copy, pdste and very last scrolling speeds. Multiple programs 

may be held In memory at once, and each program -an have Its own 

editing window and associated Icon. 

PROGRAM SIZE. There is no limit to program size, other lhan available 

memory, and Ihere Is no speed degradation lor running large programs as 

there is on many other Inleipreters. Strings may be up to 64K long, arrays 

may be over 64K. 

ASSEMBLER. Similar In concept to some basics, this allows mixing of 

assembly language and BASIC together, the ,!s»:nh^r can assemble at 

over 50.000 lines per minute making It one ot the fastest available. 



MKO 






STRUCTURED. Programs are normally written wilhout line numbers. This in 
addition to named procedures and lunctlons. ensures that FAST BASIC 
programs are easier to write and simpler to understand than any other 
programming language. 

OEM. Dlrecl and full access Is given to Ihe ST graphic such as circle, arc. 

pie, area filling etc. In addition thre Is a range ot keywords tor controlling the 
men..i;., icons and windows. II Is possible fo write program: t'"ial p.>:senl Tie 
user with a perfectly slandard GEM type interface. An example of a 
complete GEM program is supplied on the example disc. 



• ROM Cartridge 

BASIC programs. It aoes nor nave to oe to 
Instant start-up and can be permanently a 

• Example disc containing a range of exc 
lo cor- pice GEM examples. 

• Manual. Comprehensive 400 page spin 

• Quick reference card. 



pie programs from simple loops 
bound manual detailing all 



Full color tact sheet available. Demo Dlih $5. 



- $169.95 ' 



* Complete 
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PA residents add 6% sales lax. 

Shipping lr,';> Corririo'.kjl US Vju Ad:: S3 'or COD 

Paying Info: Credit Cord [no surcharge), cashier check or money order. 

To order or reques' iToduci irfornxno" pieose telephone 1-412-947-3739 

or write to Eldersofl USA. Inc PO Box 2BS. Burgettstown PA 16021. ^/sjft fift 

Deals nVDIitribul on WE NEED VOUI PI mm telephone tor dealer pack and full information 

CIRCLE 063 ON READER SERVICE CARD 



Synthesizer Sounds. 



bytes which follow (until it receives an $F7) comprise a Sys- 
tem Exclusive data dump. Here is the format of a System Ex- 
clusive dump: 

SF0I1. . . $F7 

The II byte is a manufacturer's ID Number. For example, 
$43 means Yamaha, and $04 means Moog. When an instru- 
ment receives an $F0 it checks the next byte to see if this 
message has been sent from another of the same brand of In- 
strument. 

If not, the receiver ignores the rest of the message until the 
$F7. If the manufacturer's ID is the same as the receiver's, 
then usually some additional information must be supplied 
in the following bytes to tell whether this message has been 
sent from the same model number as the receiver's. Again, if 
this does not match, the receiver ignores the rest of the mes- 
sage until the $F7. The ". . " above indicates that between the 
manufacturer's ID number and the EOX status byte there can 
be any number oi data bytes. Different instruments will re- 
quire a different number of bytes to describe a patch. In 
general, more complex instruments require more bytes. The 
only rule is that each data byte must be between $00 and $7E 

In its most basic form, a "patch librarian" is a program that 
can save and load System Exclusive data to and from a disk 
drive, and transmit and receive System Exclusive data over 
MIDI. Commercial patch librarians fall into one of two cate- 
gories: patch librarian/editors are designed to work with a 
specific brand of synthesizer, and generic patch librarians are 
designed to work with a large number of different syn- 
thesizers. 

M1DISAVE is in the second category. At first glance, you 
might wonder why someone would want a patch librarian 
that can work with only one brand of synthesizer. That 
means for each synthesizer you own, you must buy a separate 
program. The explanation is simple: generalization means 
loss of power. Dedicated patch librarians typically include 
powerful full-screen editors for modifying System Exclusive 
data. To cut costs, synthesizer manufacturers try to minimize 
the number of controls and indicators on their instruments' 
front panels. This results in more instrument for the money, 
but it also results in less user- friendliness. Editing a patch on 
a synthesizer that has only two switches and one LCD is a bit 
like using a word processor which allows you to see only one 
word at a time. 

The more sophisticated patch librarian/editors provide 
full-screen editors plus graphical analysis of wave shapes, 
envelopes, keyboard scaling curves, and operator outputs. A 
generic patch librarian, on the other hand, cannot be so 
powerful, because the bytes between SFO and $F7 cannot be 
assigned any meaning. You might be able to change those 
bytes (any decent disk utility program can do that), but you'd 
have to be a MIDI hacker at heart to obtain specific results. 



USING MIDISAVE 

MID1SAVE is a command-oriented program. Type the com- 
mand after the "%" prompt, and enter it with the Return or 
Enter key. The Control-C command requires no [RETURN] or 
[ENTERI. 

There are only ten commands: 

LIST (filenames) 

LOAD filename 

SAVE filename 

ERASE filename 

HELP 

CHANNEL n 

PATCH n 

CLOAD filename 

CSAVE filename 

Control-C 
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You can type in the first nine commands with any combina- 
tion of lower- and upper-case letters. For example, "help", 
"HELP", and "HElp"are all equivalent. Control-C, of 
course, is just the C key pressed while you're holding down 
the Control key. 

When the program loads, it automatically executes the 
HELP command. 
(A) LIST (filenames) 

This command lists the files on the disk. The optional (file- 
names) portion of the command specifies a file or group of 
files to be listed. Wild-card characters can be used within 
(filenames): "*" means any number of any characters, and "?" 
means any one character. Omitting (filenames) is equivalent 
to typing "LIST **". 

It's also possible to list files on other than the default disk. 
(The "default disk" is the one from which you booted M1DI- 
SAVETOS.) For example: 
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LIST B : *.*- list all files on drive B 
The LIST command will not work properly unless MID1- 
SAVETOS is in the root director}'. 

Type Control-5 to pause the output from the LIST com- 
mand, and Control-Q to continue. 

(B) LOAD filename 

Loads a file from disk to synthesizer. To load a file from other 
than the default disk drive, use a drive designator prefix ("A:". 
"B:" etc.). 

(C) SAVE filename 

Saves a System Exclusive data dump from the synthesizer to a 
disk file. MIDISAVE will go into a wait mode until either a 
valid system exclusive data dump is sent to it, or you type on 
the ST's keyboard. Typing a key aborts the command. To find 
out how to send a system exclusive data dump, you will have 
10 consult your synthesizer's owner's manual. Some syn- 
thesizers, such as Casio synthesizers, cannot send System Ex- 
clusive data from their front panel; the SAVE and LOAD com- 
mands will not work for them. However, see the CLOAD, 
CSAVE, CHANNEL, and PATCH commands below. 

The SAVE command will fail, with an error message, if the 
file specified already exists on the disk. Either try again with 
a different file name, or erase the file and try again using the 
same file name. 

(D) ERASE filename 

Removes a specified file from the disk. 

(E) HELP 

Lists the ten available commands and gives a brief description 
of each- When you load MIDISAVE it executes the HELP com- 
mand automatically. 

(F) CHANNEL n 

Sets the MIDI channel (n = 1-16) for subsequent CLOAD and 
CSAVE commands (see below). If MIDlSAVE's MIDI channel 
number does not match the Casio's, the ST and the Casio will 
not be able to communicate, resulting in error messages when 
the CLOAD and CSAVE commands are attempted. 

(G) PATCH n 

Sets the source or destination patch number (n = 0-99) for 
subsequent CLOAD and CSAVE commands (see below). Each 
model number within Casio's line of CZ synthesizers uses a 
slightly different numbering system Tor patches: 

• For a CZ-101 or CZ-1000: Presets 1-16 correspond to n = 
0-15. Internal patches 1-16 correspond to n = 32-47. Car- 
tridge patches correspond to n = 64-79. 

• For a C2-3000 or CZ-5000: Presets A1-D8 correspond to 
n = 0-31. Internal patches A1-D8 correspond to n = 
32-63. 

• For a CZ-1: Internal patches A1-H8 correspond to n = 
0-63. 

• For a CZ-230S: Internal patches 0-99 correspond to n = 
0-99. 

When using the patch command, keep in mind that you 



cannot select a preset patch as the destination for the CLOAD 
command. Also, Casio synthesizers other than the' CZ-101 
and CZ-1000 do not allow MIDI access to the cartridge 
patches. 

(H) CSAVE filename 

Casio synthesizers use a more complicated method of System 
Exclusive communication. A few other synthesizers, most 
notably certain Roland instruments, also use non-standard 
methods; unfortunately MIDISAVE will not work for them, al- 
though a completely professional generic patch librarian 
would. Casio's method involves a handshaking dialog be- 
tween the synthesizer and the computer Instead of you telling 
the synthesizer to dump its data by pressing a button on its 
front panel, you must send a "dump request" command over 
MIDI. The Casio then transmits the equivalent of 'Are you 
sure you want me to dump my system exclusive data?" to 
which the computer must respond with a message meaning 
"Yes, I'm sure. Now do it!" Only then does the Casio transmit 
the data for a single patch. A patch number and a MIDI chan- 
nel number are embedded in the dump request, so the Casio 
knows which patch to dump; this is why CSAVE must.be 
preceeded by the PATCH and CHANNEL commands. 
(I) CLOAD filename 

The same handshaking procedure that complicates Casio-to- 
computer communication also complicates computer-to- 
Casio communication. The handshaking goes something like 
this: The computer asks "Do you want to receive some sys- 
tem exclusive data?" and the Casio responds "If you insist." 
Of course, the computer counters with "Of course I insist! 
Here it comes. . ." The transmit request includes a destination 
patch number and channel number. 
0) Control-C 

Causes an immediate exit from the program. Warning: You 
will not be given a chance to change your mind! 

THE PROGRAM 

The only external file used by the program's source is 
OSBIND.H, which defines GEMDOS functions for screen, 
keyboard, disk, and MIDI I/O. 

Ten #define statements define the values returned from 
the getemdf) function. An eleventh #define statement 
defines a macro used by the parsing function. 

There are four global arrays; The cmdlinell array contains 
each command line entered by the user in response to the 
"%" prompt. The tokenlll and token2H arrays contain the 
output from the parser For example, if the user typed "Hello 
world", cmdlinell would contain "Hello world", and after 
parsing tokenlll would contain "Hello" and token2II would 
contain "world" The filebufll array contains MIDI data. 

The "typedef struct dta" statement creates the data type 
DTAPTR returned from GEMDOS's FgetdtaQ function. The ► 
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data type DTAPTR points to a 44-byte structure created by 

GEMDOS's Fsfirst( ) and FsnextQ Functions. 

main( ) 

As with any C program, execution begins with main(). The 

main() function here consists of an infinite loop. However, 

the Cconrs() and CconwsO functions intercept the Control- 

C command and abort from the program, giving us a "free" 

command to exit MIDISAVE. The while(l) loop branches to 

one of ten command handlers based on the value of the local 

variable cmd, and then calls function getcmd() to redefine 

the value of cmd. At the start of main( ) cmd is set to HELP 

so that on the first time through the while(l) loop the 

do_help() command handler will be executed. 

getcmd() 

The getcmdC) function first erases any previous command in 
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the cmdlinel] array. Then it displays the cursor at the start of 
the next line. Note throughout this program that every 
Cconws() call includes the line -feed -plus- carriage-return se- 
quence, "\n\r" Calling Cconrs(cmdline) fills cmdlinel! with 
a new string whenever the user types 1RETURNI or (ENTER!. 
Before calling Cconrs( ), the first byte in cmdlinel I is set to 
80 to tell CconrsQ the maximum number of characters to ac- 
cept. The prompt and input command line sequence is in- 
side a do. . .whileO loop, so that entering a null command 
will cause an immediate prompt for another command. Once 
a non-null command line is entered, getcmd() calls 
lc_to_uc() to convert lower case letters in the command line 
to upper case. This allows commands to be typed with any 
combination of lower- and upper-case letters. Next, getcmd() 
calls parsef) to parse the command line into two tokens. The 
first token is compared to each legal command string. If a 
match is found, the corresponding #defined value is 
returned. If no match is found, the BADCMD value is 
returned. 
parseC) 

The parsing function first erases the previous two tokens. It 
then searches from left to right through the command line. 
When a non-space is encountered it begins copying the com- 
mand line into the first token. It copies until it encounters a 



space. Then it continues searching until it finds another non- 
space, at which point it begins copying the command line 
into the second token. It copies until it encounters either a 
space or the end of the command line. 
do_load() 

The do_load() command handler is called in response to 
the LOAD filename or CLOAD filename commands. First, it 
checks for a file name following the "LOAD" or "CLOAD" 
portion of the command. We open the specified file, and then 
we call FsfirstQ to determine the file's length. A file longer 
than 50000 bytes won't fit into the filebufll array, so in that 
case we write an error message, close the file, and return to 
mainf). Otherwise, we read the file, and transmit the con- 
tents of filebufll over MIDI. Finally, we close the file and re- 
turn to main(). 
do_save( ) 

The do_save() command handler is called in response to 
the SAVE filename or CSAVE filename commands. First, it 
checks for a file name following the "SAVE" or "CSAVE" por- 
tion of the command. Next, we attempt to open the specified 
file. If this succeeds, then the file exists, and we write an error 
message, close the file, and return to main(). This means that 
the SAVE command cannot overwrite a file. If we find that the 
specified file does not yet exist, then we create it. Next, we 
call receivef) (c_receive() lor the CSAVE command) to fill 
filebufll with system exclusive data. The receive() or 
c_receive() function returns the number of bytes received 
over MIDI. If this number is zero, then the user has opted to 
abort the SAVE command by typing a key on the ST's key- 
board while receive( ) was waiting for MIDI bytes. If receivef ) 
returns a number greater than zero and less than 50000 then 
we write the contents of filebufll to the newly created file, 
close the file, and return to mainf ). 
do_erase( ) 

The do_erase() command handler is called in response to 
the ERASE filename command. It checks for a file name fol- 
lowing the "ERASE" portion of the command. If there is one, 
we' delete the specified file and return to main() 
do_help() 

The do_help() command handler is called in response to 
the HELP command. A series of Cconws() calls writes a 
summary of all available commands on the screen. 
do_patch( ) 

The do__patch() command handler is called in response to 
the PATCH n command. The n portion of the command is 
converted into a number and stored into the handshaking 
commands for Casio communication. 
do_channel( ) 

The do_channel() command handler is called in response 
to the CHANNEL n command. The n portion of the com- 
mand is converted into a number and stored into the hand- 
shaking commands for Casio communication. 
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do_badcmd( ) 

The do_badcmd() command handler writes the error mes- 
sage "Unrecognizable Command" for an illegal tokenlll 
returned from parse( ). 
do__list( ) 

Ihe do_list() command handler is called in response to the 
LIST (filenames) command. First, we check for the (file- 
names) portion of the command. If there is none, we use "**" 
for chat portion. Next, we check for files matching the 
specified (filenames). If there is at least one matching file, we 
write that file's name. Then we loop, calling FsnextQ until it 
returns a non-zero number. Each time we call Fsnext( ) it puts 
another file name matching the specified (filename) into the 
DTA created by FgetdtaQ. 
receive( ) 

First, we find pointers to the heads and tails ol the MIDI and 
Keyboard input queues. When head and tail are not equal, 
there is a byte available from that device, and we can read it 
with the Bconin( ) function. Checking head against tail is 
faster than calling BconstatQ. For MIDI I/O we need to be as 
fast as possible, to avoid losing bytes at the end of a long Sys- 
tem Exclusive data dump. 

The loopl loop checks the Keyboard and MIDI input 
queues until either is not empty. If the keyboard queue is not 
empty, then we return a long zero in DO to request an abort 
from do_save( ). If the MIDI queue is not empty, we read a 
byte and check for SFO. We continue with loopl until either 
a key is typed or an SFO is received. When we receive an 
SFO, we put it into filebufll and set our byte count to 1. Then 
we start the loop2 loop. 

The loop2 loop checks the Keyboard and MIDI input 
queues until either is not empty. If the keyboard queue is not 
empty, then we return a long zero in DO to request an abort 
Irom do_save(). If the MIDI queue is not empty, we read a 
byte and check for SFE or SF8. The SFE status byte is called 
"Active Sensing," a MIDI instrument's way of saying "Here I 
am!" The $F8 status byte is called "MIDI Clock." MIDI drum 
machines and sequencers use it to synchronize themselves. 
For our purposes, SFE and SF8 bytes can be treated as if they 
do not exist. Any other status byte is converted into an EOX 
status byte, SF7, and terminates loop2. If the received byte is 
a data byte it is appended to filebufll, the byte count is in- 
cremented, and we continue with loop2. 

If the byte count exceeds 49999, then we return a long 
50000 in DO to request an overflow error message from 
do_save(). 
c_receive( ) 

The c_receive() function is essentially the same as the re- 
ceive( ) function, except that the proper handshaking for Ca- 
sio communication is done first. 



REVERB 

As generic patch librarians go, MIDISAVE is very primitive. (1 
wrote it in one evening.) It can't even begin to compare with a 
good, full-featured generic patch librarian. On the other hand, 
you could pay up to $150 for some commercially-available 
generic patch librarians no more capable than MIDISAVE. For 
novice programmers, MIDISAVE demonstrates effectively the 
general principles of communicating over MIDI. More ad- 
vanced programmers will have fun modifying the program to 
work with a wider range of instruments. ■ 

IF YOU'D LIKE TO SEE MORE ARTICLES LIKE THIS ONE, 
CIRCLE 182 ON THE READER SERVICE CARD 
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START compares five BASlCsfor the ST: Atari 's ST BASIC, 
SoftWorks BASIC, Logical Design Works Compiler, Com- 
puter Concepts' Fast ST BASIC, and MichTron's GFA 
BASIC -including a critical analysis of each programs fea- 
tures, documentation and support. 



^^k ASIC is the language of choice for many programmers and aspiring programmers. 
fC It is quick, compact, and does its job. As of March 1987 there are five BASICs avail- 
s' able for the Atari ST computers. They are very different, and the purpose of this 
article is to compare their merits and drawbacks. 

The first BASIC is Atari's ST BASIC, packaged free with your ST. Much has been writ- 
ten about this language and its shortcomings, and it is a standard of sorts: everyone has 
a copy, and listings you see printed in magazines are likely to be written in ST BASIC. 

LDW BASIC is not really a separate BASIC at all, but a compiler for ST BASIC, and it 
shares many of the limitations of ST BASIC. But LDW BASIC solves the problem of ST 
BASIC'S slow speed: LDW's compiled code is very fast. Revision 1.1, which arrived just 
before we went to press, includes some significant enhancements over the original version. 
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BASIC COMPARISON 








ST BASIC 


LDW 


SoftWorks 


Fast ST 


GFA 


Manufacturer 


Atari 




Logical 
Design Works 


SoftWorks 

Limited 


Computer 
Concepts 


MichTron 


Media 


Disk 




Disk 


Disk 


ROM 

Cartridge 


Disk 


Price 


Free 




$69.95 


$79.97 


$139.95 


$79.95 


GEM/TOS 


GEM 




GEM 


TOS 


GEM 


GEM 


License 


None 




Public Domain— None 
Commercial — $300 


$25 


None 


None 


Time (in seconds) 






V.1.0. V.l.l. 








Value of Pi 


4.20 




.93 1.03 


2.70 


1.10 


.75 


Sum of Sines 
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.12 


.14 


Sum/SqRoots 


.25 




.08 .07 


.98 


.10 


.10 


Real Count 


11.52 




1.10 1.13 


4.23 


2.75 


1.10 


Int. Count 


9.55 




.70 .75 


7.68* 


2.0 


.39 


Gosub 


1.85 




.17 .18 


.55 


.30 


.21 


String Handling 


1.57 




.22 .25 


1.28 


.35 


.34 


Disk Access 


21.52 




11.25 13.22 


14.67 


8.65 


12.58 


Compile/Link 







9:08 4:26 


0:15 








*SoftWorks Limited converts all intege 


rs back to floating point, so 


integer operations are slower. 





SoftWorks BASIC is totally different from ST BASIC; I had 
to completely rewrite the benchmarks to test it. It is compiled 
and fast, as well as being portable -applications which don't 
use GEM or other ST-specific features will run unmodified on 
a Macintosh or Amiga. 

Computer Concepts' Fast BASIC is the first ST cartridge 
BASIC. An import from England, it is without a doubt the 
easiest to use and most powerful of the languages I surveyed. 

Finally, GFA BASIC is a German import that's powerful and 
very fast, but currently suffers from a poor manual. It in- 
cludes a run-time package and should have a compiler avail- 
able soon. 

(Editor's note: Readers may notice that Philon's FAST/BA51C- 
M has not been included in this comparison. At the time we pre- 
pared this article, Philon was revising their program extensively and 
ashed that it not be included. We hope to present a review of the 
revised program in a future issue of START) 

BASIS OF COMPARISON 

The comparisons I make in this article are different from 
those you may have seen in other language comparisons, 



since users generally require different things from BASIC than 
they would of a language like C. BASIC users don't expect 
lightning- fast execution, though speed is important for writing 
complex applications. BASIC users tend to be hobbyists, not 
developers, and often do not have access to technical infor- 
mation about the machine, so special features (such as GEM) 
must be implemented within the language if they are to be 
used extensively 

BASIC users also have varying levels of experience with the 
language (and computers, for that matter). Documentation 
that is adequate for an experienced user may leave a novice 
totally lost. None of the manuals that come with these BASICs 
are designed to teach the language, but even as reference 
manuals they vary widely in quality and usefulness. 

With all these points in mind, we will look at each BASIC: 
calculating speed, quality of documentation (including GEM 
support) and ease of use. 

SPEED AND BENCHMARKS 

A benchmark is a short program that performs a task on a 
computer; it's used to measure how fast and accurately the ► 
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task was performed. Benchmarks don't always test what they 
claim to measure, but no comparison would be complete 
without some measure of performance. 

Benchmarks can measure some important features. 
Floating-point math and trigonometric functions are impor- 
tant to an engineer like me-and so is the speed penalty for 
using floating-point numbers instead of integers. String han- 
dling is essential for applications like telephone and address 
books and other mini-databases, and the time required to 
write large chunks of data to disk is also significant. 

On your START disk you'll find [our different benchmark 
files, because I had to significantly modify the benchmark 
program for the different BASICS. The changes help highlight 
the differences between the languages. For example, ST BASIC 
uses GOTOXY to position text on the screen. GFA uses PRINT 
AT. Two others use PRINT TAB: SoftWorks BASIC puts the y- 
coordinate first, while Fast ST BASIC uses the more familiar 
order of x-coordinate first. SoftWorks also has no screen 
clearing command, and instead of LPR1NT you must open a 
channel to the printer. Fast ST BASIC has an LPRINT com- 
mand, but it didn't work- 1 had to use the VDI function to 
echo screen PRINT to the printer. 

String handling also had some significant differences. ST 
BASIC and GFA BASIC use the STRINGS command to fill a 
string with characters. With MIDS they can pick out a por- 
tion of a string or set the contents of a substring. SoftWorks 
cannot set the value of a substring using MIDS, so I used sub- 
string operators instead. Fast ST BASIC has a STRINGS com- 
mand, but it didn't work- and neither did setting a substring 
using MID$. In each case concatenation was used to build the 
string. 

Finally, to time a benchmark, you must have access to a 
timer. The 5T has a timer that counts in jiffies (60ths of a sec- 
ond), using the four bytes starting at $462. In ST BASIC, you 
can use DEF SEG and a double precision variable to read all 
four bytes at once. SoftWorks uses the LONG function to do 
the same job. Fast ST BASIC has multiple byte operators 
called "indirection operators," but they crash the machine, so 
I was reduced to using single-byte PEEKs and multiplying out 
the results. GFA BASIC has a built-in timer calibrated in incre- 
ments of 1/200 of a second, so I had to do a conversion to get 
comparable times. 

ST BASIC 

Ah, ST BASIC. If you want to write a BASIC program that any- 
one with an ST can run, this is the language to use. ST BASIC 
is a lull-featured generic BASIC that allows access to rudimen- 
tary graphics and sound. It supports random and sequential 
disk access and program chaining; string-handling is good, 
and mukiple-byte PEEKs and POKEs are possible (though 
clumsy). WHILE and PRINT USING make structured pro- 
gramming and printing easier, and a full range of debugging 



tools including TRACE and FOLLOW are available. 

However, many ST BASIC operations are sloooow, and in its 
current version there are significant bugs. The floating-point 
package, for example, is not particularly accurate. In fact, 1 
have not been able to obtain satisfactory results from ST 
BASIC on a number of engineering calculations. 

ST BASIC supports GEM only in a limited way. Some 
graphics and sound functions can be used with keywords, 
but alert and dialog boxes, menus, windows and fancy 
graphics are only available using POKEs and a pair of generic 
GEM commands, VDISYS and GEMSYS. The syntax of these 
commands is given in the manual, but little else; for detailed 
information or examples of how to use GEM calls, you will 
have to turn elsewhere. I think many people who purchase 
the ST to program it in BASIC fully expect to be able to use 
the GEM features in a straightforward manner; for them, ST 
BASIC will be a disappointment. 



LDW BASIC'S 

compiled code is 

very fast, and Revision 1.1 

includes some significant 

enhancements over the 

original version. 



DOCUMENTATION 

The ST BASIC documentation includes instructions to get you 
started, an alphabetized list of keywords and a few sample 
programs. It is a good reference manual-better than I've seen 
with other languages-and should be adequate even if you are 
only moderately experienced with another version of BASIC. 
With some perseverance, you could leam to program in ST 
BASIC from it. 

Listing the keywords alphabetically often gives strange re- 
sults: ENDWHILE is listed before WHILE, and ELSE before IF, 
so the explanations of these keywords make little sense if you 
read the manual straight through. Atari did some rearranging, 
explaining some closely related keywords at the same time. 
Each keyword is accompanied by several short examples, 
which help clarify the uses for the keyword. 

USING ST BASIC 

Entering programs in ST BASIC is a chore. The editor consists 
of four different windows: EDIT, OUTPUT, LIST and COM- 
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MAND. These windows shift discractingly, moving in front of 
one another as you execute different commands. Further, 
changes to text in the EDIT window leaves difficult- to- read 
"ghost" text in its place. Having two windows, one for the 
program listing and one for the output, can sometimes be an 
advantage, but too many windows make programs slower and 
programming more difficult. (My article on using ST BASIC in 
the Winter 1986 issue of START gave some pointers on how 
to circumvent some of this clumsiness.) 

Running a program is made simple by the fact that ST 
BASIC is a GEM application. Thus, attempting to load a file 
will bring up the familiar File Selector Box, so that you don't 
have to remember what files are on the disk. Pull-down 
menus can RUN or BREAK the program, and give easy access 
to the editing tools. ST BASIC is interpreted, so that you can 
run the program right away, make changes, check variable 
values, and run it again. This simplifies debugging considera- 
bly. The program, of course, runs slower than if it were 
compiled. 

SUPPORT 

Support for ST BASIC is only fair Atari has a customer service 
number (408-745-2367) that may be able to answer your 
questions. Because ST BASIC has been widely distributed, 
you can probably also get answers from your local user group, 
a friend, or magazines like ANTIC and START. If you own a 
modem, you can post a notice on a bulletin board or infor- 
mation service like CompuServe or GEnie and get a quick an- 
swer Atari users are well known for their willingness to help 
others, and I suspect this is the best support of all. 

SUMMARY 

ST BASIC will cost you nothing extra, and is a good learning 
tool, with decent documentation and widespread help avail- 
able. But if extreme accuracy, speed or GEM access are very 
important to you, then you should probably explore another 
BASIC. 

LDW BASIC COMPILER 

The LDW BASIC Compiler is a compiler for programs written 
in ST BASIC that also implements a number of enhancements. 
A compiler converts a program into machine code, so the 
final result of the LDW compiler will usually run many times 
faster than the interpreted ST BASIC version could. 

There are two reasons why many people prefer inter- 
preters over compilers. First, a compiled program must nor- 
mally be written, compiled and tested; if anything doesn't 
work properly (usually the case), you must go back to your 
original program, correct it and recompile-a process that can 
be very lengthy. Second, it can be very difficult to find the 
problem in a compiled program, since you can't just print out 
the values of variables to see what is going wrong. To get at 



variable values, you must build debugging statements into 
your program to print them out, then remove those state- 
ments after the program is working. 

The LDW BASIC Compiler gets around these problems by 
compiling ST BASIC. Thus, you can write a program in inter- 
preted ST BASIC and debug it; once everything works 
properly (but slowly), you can compile to produce a fast ver- 
sion. Although you may not get exactly what you want the 
first time (it may be too fast), the amount of back-and-forth 
debugging is kept to a minimum. 

Since the LDW BASIC Compiler is designed specifically to 
compile ST BASIC, it has most of the same drawbacks, except 
speed. Some enhancements have been built-in; line numbers 
are optional, and the constraints on array and string size, as 
well as number of lines, have been removed; there's double- 
precision math, and a multiple-pairs version of LINEF lets 
you draw many lines using one command. Of course, since 
these enhancements are not available in ST BASIC, you will 
have to go back to the compile -debug- fix cycle it you want to 
use them. A very few normal ST BA5IC commands do not 
work in the compiler, but they are well documented and not 
likely to cause trouble. 

The newest version of the LDW compiler, revision 1.1, 
adds many new commands including some to read and set 
the time and date, enable and disable the break key ((Control! 
IC1), and enable the output window. Unlike the original ver- 
sion, it has no copy- protection, and it includes a variety of 
batch files for compiling and linking your ST BASIC program. 
Also available is the option to not produce the assembler 
source code, which saves a great deal of time and disk space. 
Using a RAMdisk or hard disk cuts the time required still fur- 
ther. One of the batch files for two-drive systems allows you 
to simply walk away and come back later to find everything 
done, with the .PRG file on your disk. 

Another enhancement is the inclusion of GEM bindings - 
subroutines that do all the dirty work of calling GEM and AES 
for you. For example, to create an alert box you simply set two 
variables and GOSUB FORM_ALERT The subroutine will 
even return the number of the button in the alert box you 
clicked on. The use of the GEM bindings is much more 
straightforward than POKEing and PEEKing in ST BASIC. The 
bindings are well documented, noting what variables must be 
set and what they are, and what special arrays must be 
dimensioned; the documentation includes page numbers in 
Atari's GEM manuals and Abacus Software's Atari ST GEM Pro- 
grammer's Reference for finding further information. The GEM 
bindings will even work in regular ST BASIC programs, and 
they are a valuable addition to the LDW package. 

DOCUMENTATION 

The manual is dedicated strictly to how to use the compiler, 
and generally does a good job. The first section tells you what P 
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enhancements have been added to ST BASIC, and then how 
to actually compile a program. It is explicit about the disks 
you must set up and the exact steps to follow. 

The balance of the manual discusses the options available 
during compile, and contains more details about the language 
implementation (such as double-precision and bugs in ST 
BASIC). The details tend to be overly technical and the lan- 
guage is often stilted-but you can figure out what's going on. 
The explanation of GEM access is no better than in the ST 
BASIC manual, but the GEM bindings available in revision 1.1 
make GEM access easier. While the technical section will be 
incomprehensible to most BASIC users, you don't need this 
section to make the compiler package work. 

USING THE LDW BASIC COMPILER 

The package consists of an assembler, linker and compiler, 
along with the EMACS editor. If you are using straight ST 
BASIC code, you can just use the ST BASIC editor. If you don't 
want to use ST BASIC, or are going to be using some of the 
enhancements, I suggest you try a word processor such as 1ST 
Word; the EMACS editor is pretty unwieldy and entirely 
command driven (no GEM). 

After you've created your BASIC program, you follow the 
manual's instructions for your system configuration. The 
LDW BASIC Compiler will take your BASIC source code and 
create assembler source code (if you choose that option), 
assemble to object code, link the necessary files, and modify 
the resulting code to make it relocatable. When the compile- 
(assemble)-link-RELMOD cycle is complete and you have 
created your final .PRG file, you can transfer it to another disk 



SoftWorks 

BASIC is compiled, fast 

and portable. 



and use your working disks to compile your next effort. The 
working disks will fill up fast, since some huge intermediate 
files can be created while compiling, but most of these files 
are automatically erased when the program finishes. 

SUPPORT 

Support for the LDW BASIC Compiler is surprisingly good, 
both by phone (408-435-H45) and mail. LDW has mailed 
several bulletins to all registered owners, addressing common 



problems. Their enhancement policy is also fair: revision 1.1, 
with a brand new manual and two disks, is available for only 
$25 to registered users. 

SUMMARY 

The LDW BASIC Compiler is the only one that can compile 
ST BASIC It does a good job of it, and if you have written a 
good (but slow) ST BASIC program, this may be what you 
need. The benchmark results are impressive, and with its new 
lower price ($60 less than the original price) it is an excellent 
value for those who need its unique capabilities. 

SOFTWORKS BASIC 

SoftWorks BASIC bears little resemblance to ST BASIC. It is a 
compiled BASIC, with all the inherent disadvantages com- 
pilers present for debugging. This was brought home force- 
fully to me when I programmed the benchmark, since it took 
several passes to get it to run successfully. 

A SoftWorks BASIC program actually compiles to an inter- 
mediate code called p-code, which does not run as fast as the 
machine code generated by LDW, but compiles much faster. 
A run-time package (provided with SoftWorks BASIC) must 
be present on the disk for your compiled program to run Us- 
ing the compiler itself and running the compiled .RUN file 
was very simple, since version 2.0 supports standard GEM 
file selector boxes. 

SoftWorks BASIC supports a iatrly complete set of com- 
mands, although it is missing such advanced features as 
procedures, WHILE, and CASE. Many of the keywords that 
experienced BASIC programmers expect to find are missing 
or have different names, which can cause some confusion. 
On the other hand, this BASIC has some powerful extensions, 
such as mapped variables (similar to RECORD types in Pas- 
cal), substring operators, routines to move blocks of memory, 
and arrays up to seven dimensions. You can also do multiple- 
byte PEEKs much more easily than in ST BASIC- 
GEM support in SoltWorks BASIC is there, but you have to 
know how to use it. All the special (not generic) ST GEM 
functions are available through the TOOLBOX command. You 
can use not only VDI and AES, but XBIOS and GEMDOS as 
well. The TOOLBOX commands mirror the C language calls 
closely, so if you know your way around GEM, you can con- 
struct a fully GEM-based application. The catch is, you must 
know your way around GEM; I suspect many BASIC pro- 
grammers do not, and the documentation is no help. Since 
there is absolutely no support for any kind of graphics, sound, 
windows, alert and dialog boxes, and menus outside of the 
TOOLBOX command, the programmer who isn't familiar 
with GEM will not be able to use any of these features. This is 
much worse than ST BASIC, which at least lets you do some 
graphics and sound. The GEM-ignorant programmer will be 
able to produce only "plain vanilla" generic BASIC programs ► 
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with SoftWorks BASIC. Of course, this may be all you want- 
it's enough for engineering problems. But even dry applica- 
tions can benefit from a little spicing up. 

DOCUMENTATION 

The SoftWorks BASIC manual begins with four pages explain- 
ing what a program is, followed by the section on using the 
compiler One place where this manual gets high marks: In- 
stead of using strictly alphabetical listings of the keywords, 
they are broken up into sections such as General Statements, 
File I/O, and Error Trapping. Unfortunately, the explanations 
that accompany the keywords are quite technical, and will be 
difficult for the beginner to understand. In fact, the manual is 
called a "technical reference manual," and that is primarily 
what it is. 1 would have to categorize this as a BASIC for the 
moderately advanced programmer; the documentation is ade- 
quate for someone who has learned another version of 
BASIC. 

As I mentioned before, the only access to any GEM sup- 
port at all is via the TOOLBOX command. Here the manual 
falls down. Although the TOOLBOX command parameters 
are in a separate section, the descriptions are cryptic and of 
little help. There are no examples of how the various com- 
mands tie together to, say, open a window. Since this sort of 
information is currently very hard to find, the average user is 
left without any access to GEM. 

SUPPORT 

Numerous calls to SoftWorks have convinced me they are 
serious about their support. A programmer is available most 
of the time, and SoftWorks seemed genuinely interested in 
helping me find out why something wouldn't work. They 
were never condescending, although not all of their program- 
mers are as familiar with the ST version of SoftWorks BASIC 
as with other versions. 

SUMMARY 

If you don't need any GEM support, but want speed of execu- 
tion without mind-numbing compile times, this BASIC will 
probably fit the bill. Its GEM support may become accessible 
later, as the documentation for the Atari ST and GEM gets bet- 
ter. It is very different from any other BASIC I have used, so 
there is a fairly steep "learning curve" until you begin to think 
in this new language. (Editor's note: For another perspective on 
SoftWorks BASIC, see Chris Chabris' article "Shoestring Develop- 
ment" in the Winter 1986 issue oj START.) 

FAST ST BASIC 

Computer Concepts' Fast ST BASIC is the most powerful of 
the currently available BASICs. It sports a tremendous num- 
ber of commands, giving the user unprecedented control over 
the program. It is also simple to use, provided on cartridge 
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and totally GEM-driven. The desktop includes printer, disk 
and clipboard icons, as well as icons for each of the up to 10 
programs that can be loaded in at once. LOADing, SAVEing 
and PRINTing are simply matters of dragging one icon on top 
of another. The drop-down menus are helpfully arranged, and 
the arrangement of the screen makes it easy to see both the 
output and listing at the same time. 

Fast ST BASIC comes with a powerful editor for entering 
programs. It includes many features found in word proces- 
sors, such as sophisticated cursor control, case and letter 
swapping, cut and paste, search and replace, and auto-indent. 
There is no syntax checking when you enter a program, so 
debugging must take place at run-time (but Fast ST BASICs 
variety of commands help with debugging). It even has a 
built-in assembler so that assembly language source code can 
be part of the program listing, and the code will be automati- 
cally assembled when you run the program. 

The scope of built-in commands is impressive. Besides all 
the "normal" keywords you would expect to find, Fast ST 
BASIC allows for elements of structured programming 
(PROCEDURES and FUNCTIONS), advanced loop and deci- 
sions (WHILE, CASE, REPEAT), access to the system (folders, 
directories, time and date, drive information, screen resolu- 
tion and location), single- and double-precision variables and 
functions, and two ways of bit-blitting. The built-in keywords 
for moving blocks of bits around the screen are fast and easy 
to use 

Fast ST BASIC also has the best GEM support of any of the 
BASICs. All VDI graphics are available, allowing you to put 
lines and shapes on the screen, set drawing mode and color, 
and print text using built-in commands rather than using ST 
BASICs numbered calls. This BASIC even supports many of 
the GEM AES calls, such as alert boxes, windowing, menus, 
and events, although not dialog boxes. 

There are still some bugs in Fast ST BASIC, including key- 
words that don't work and less crash protection than usual. 
The latter is probably because of the enormous power of the 
language. It allows you to do so much that you can get your- 
self into trouble! Fast ST BASIC is also very sensitive to syn- 
tax: Failing to capitalize a keyword will cause BASIC to treat it 
as a variable, and an extra space or semicolon in the wrong 
place will cause an error. There is virtually no support for 
sound, and only single-byte PEEKs and POKEs are allowed 
into system memory-the multiple byte operators will crash 
the machine and cannot be used to work with the more in- 
teresting memory locations. 

DOCUMENTATION 

Fast ST BASICs thick manual has a section on the editor 
(which doesn't cover all the options), some information on 
variable types, and then the alphabetical listing of all key- 
words. No mention of strings or arrays is made, and file han- ► 
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dling is left for an appendix. The explanations of the key- 
words themselves are pretty good, with sample program 
illustrations. The keywords dealing with GEM AES support 
are in a separate section, also arranged alphabetically. This 
makes little sense and 1 found it confusing. The AES explana- 
tions are not as complete as they could be, but are still better 
than any other BASIC. 

SVPPORT 

This is an easy one -currently, there is no support. Computer 
Concepts is based m England, and there is no customer sup- 
port contact in the US or Canada. A program such as this one, 
which is fairly expensive and still has some bugs, needs tech- 
nical support to make it a success. 

SUMMARY 

This is a great language to experiment with. Its implementa- 
tion is extremely powerful, but is limited by the lack of sup- 
port, some bugs, and the absence of a run-time package A big 
plus for the "power user" is the excellent GEM support and 
built-in assembler 

GFA BASIC 

MichTron's GFA BASIC is both powerful and very fast. It has a 
large number of commands-not as many as Fast ST BASIC, 
but GFA is not as prone as Fast ST BASIC to crash. Included 
with the package is a run-time version of the language, which 
you can give out freely so that people who do not own the 
language can use your applications. 

GFA BASIC has two screens: one is a powerful text editor, 
the other is used for output from your program. The text edi- 
tor's features include copy, cut, paste, find, and replace You 
may enter commands using short abbreviations, and the edi- 
tor will print out the commands on the screen in their en- 
tirety when you press [Return]. Syntax checking is immediate, 
as in ST BASIC, and there is also a command to check the 
structure of loops. The text editor does not use drop-down 
menus, but does have commands across the top of the screen 
that you can click on with the mouse. You can also use key- 
board commands. 

The text editor indents lines automatically when they are 
within a loop or Procedure so that you can easily tell where 
the bounds of the loop are. It even lets you switch into the 
high resolution mode where 48 lines of text will fit on one 
screen. GFA BASIC uses labels instead of line numbers. Be- 
cause of the two screen set-up, you can switch back and forth 
between your listing and the output whenever you like 

All standard features of BASICs are well represented. You 
also have some powerful extras, such as DO/LOOP, RE- 
PEAT/UNTIL and WHILE/WEND (but no CASE statement). 
You have access to a timer, and to the system time and date; 
you can define your own functions and procedures with local 
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variables. Bit blitting via both built-in commands and the 
GEM BitBlt is supported. 

GFA BASIC offers quite a bit of GEM support, although not 
as much as Fast ST BASIC. Commands for graphics shapes, 
fills, colors, text and markers are all built into the language. 
Full mouse control, including coordinates and condition of 
the mouse buttons, and the ability to set the shape of the 
mouse pointer are available. You can build and install your 
own menus, control various aspects of any of four different 
windows, and detect most important occurrences (keyboard 
input, mouse position, GEM messages and menu selection). 
There is even support for Alert boxes, although not for Dialog 
boxes. You can access VDI and AES by numbered calls for 
any function not supported, as in ST BASIC. You use XBIOS 
and BIOS functions the same way. 

The windowing system is a little clumsy, and the GEM 
support is not as effective as it could be because the 
documentation doesn't provide enough information. There 
are also some minor bugs in GFA BASIC-for example, PRINT 
USING doesn't work properly under certain circumstances. 

DOCUMENTATION 

GFA BASIC comes with a thick manual that launches straight 
into the editor, and then proceeds to document the com- 
mands in alphabetical order. A few notes about such impor- 
tant matters as variable types are not included until the very 
end, leaving you somewhat confused when those variable 
types show up in the main body of the documentation. Some 
items, such as arrays, are not mentioned at all. 

The manual is also laced with typographical errors and 
language that is incomprehensible in some places and just too 
technical in others. MichTron assures me that the manual is 
being completely rewritten to correct the language and typos. 
Each keyword is accompanied by an example, which goes a 
long way toward clarifying how the command works. Unfor- 
tunately, even these examples have typos. The explanations 
accompanying some of the GEM features (such as windows 
and messages) are extremely sketchy and will likely not be of 
much use to anyone but an experienced GEM programmer 
Perhaps the manual rewrite will correct this as well. There are 
only a very few example programs on the disk, and one of 
these is not complete — several procedures are missing. 

SUPPORT 

GFA BASIC was created in Germany, but support is provided 
by MichTron. A programmer at their offices answers ques- 
tions, and the support seems to be pretty good, especially for 
a product as new as this one 

SUMMARY 

GFA BASIC is veiy fast and easy to use, due to its editor and 
variety of commands. It is really not for the inexperienced, ► 
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DISCOUNT SOFTWARE 

37 S. Broad St. 
Fairborn, Ohio 45324 

ORDERS ONLY PHONE: 1 -(800 1-282-0333 
*™™"s?™rir" 1-<5 13)879-9699 



ATARI ST HARDWARE 

5ZD ST CPU W/'RF MODULATOR, MOUSE ff SOFTWARE 

SF 314 3S" DS/DD DISK DRIVE 

SF 354 iW SS/DD DISK DRIVE 

SC 1224 12" RGB COLOR MONITOR 

SM 124 12" MONOCHROME MONITOR 

SH 204 20 MB HARD DRIVE 

SMM 804 DOT MATRIX PRINTER 

1200 BAUD MODEM 

PS 3000 (MONITOR ti DRIVE) 

CALL FOR NEW PRICES!! 

INDIVIDUAL ITEMS OR PACKAGES 

SOFTWARE HITS 




S48.00 Che* 



Figii Simulator II 3<1 00 

Personal Pascal 49 00 

Doco Space . 00 

SD: 3? 00 
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ATARI ST 
SOFTWARE 



News Station ST 



$34.95 



" Create an entire page 

' Use entire ASCII files 

' Use Print Master(trn) icons 

' Use Degasitmi and NeoChromeitm) pictures 

* Cut and Paste from clipboard 

" Use any graphics supporting printer 

Dish Master $29.95 

* Recover damaged data on both the 

sector and track level 
' Custom Formatter 

* Disk analyzer 



ENTERTAINMENT 

World Class Hockey $29.95 

An action packed hockey game which features 

* MIDI sound 

' Realistic arcade action 

* Passing saves skating, face offs 
' League play in the 3HL 

Now available at your local dealer or direct. To 

order send a check money order or call for a 

COD Free Shipping on prepaid orders 

Reeve Software 






29W150 Old Farm Lane 

Warrenville IL <MS5S 

1312) 393-2317 
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HAVE YOU SEEN THE Dr. LATELY 

The Dr. . . . developing amazing new software for the ST! 
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KEYBOARD CONTROLLED SEQUENCER ST 
The ST-KCS contain* THREE modes of operalion: 

TRACK MODE is an automated 46-track tape recorder using th B mouse toselei 
major functions. It features a "continuous overdue" function allowing patterns to Be 
built up layer-by-layer in REAL TIME with NO STOPPING! Tracks can be MUTED, 
UNMUTED. or SOLOED; tempo changed; recording of CONTROLLERS or AFTER- 
TOUCH toggled on or off; PUNCH points SET and PUNCH-IN and PUNCH-OUTS 
recorded: and output ECHOED to any MIDI channel. 

SONG MODE provides 126 sequences which maybe recorded on, edited, indep. 
ently looped, and chained together In ANY manner desired. 
OTHER FEATURES include FULL editing of ANY MIDI event or parameter: tr 
position of velocity, duration, and pitch; auto-correct; inversion, retrograde; 
tremely flexible CUT and PASTE: and many more edit options. SMPTE is supported 
through MIDI Song Pointer. A velocity-scaling feature allows easy creati 
crescendos and decrescendos. Tracks can be split by Synth key-position. STEP- 
TIME entry functions allow you to painlessly enter parts that you t tjht be unable tc 

220 Boylston Street, Chestnut Hill, MA 02167 
(617) 244-6954 
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Introducing 

VSH Manager** Irom 

Beckemeyer Development 

Tools 



Open a window to 

MT C-Shell 1 " and bridge ¥g 

the GEM'" multitasking gap, \X* 



VSH is a "Visual Shell" interface to MT C-Shell. It manages 
a "virtual" terminal session with a GEM Desk accessory 
window, where you can type commands and run jobs — 
while using your favorite GEM Application! Start a 
command running, and then return to your GEM application 
while it finishesl 

All the fantastic features of our Multitasking MT C-Shell 
svstem have never been easier to use. You have on-demand 
access to electronic mail, print spooling, and over 70 
commands and utilities — plus you can easily add your 
own commands and combine existing ones to produce a 
never ending array of features. 

If you've been waiting for a multitasking system that was 
cost effective and simple to use, wait no longer. It's here 
with MT C-Shell'" and VSH Manager'" from Beckemeyer 
Development Tools the leader in Atari ST'" multitasking 
multiuser systems. 

Beckemeyer Development Tools 

478 Santa Clara Ave., Suite 300 MT C-Shell system $129.95 

Oakland, CA 94610 VSH Manager $34.95 

415-452-1129 B.B.S. 415-452-4792 On-Line Manual $19.95 
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ST Basics. . . 

and some important information is missing from -the current 
version of the manual. If you are mildly proficient in another 
BASIC, though, you will enjoy using this powerful version. 
The presence of the run-time package will also allow distribu- 
tion of your efforts. A compiler will be available by the time 
you read this. 

CONCLUSIONS 

Of the five BASlCs we have looked at, three are interpreted 
(ST, GFA and Fast ST), and two are compiled (LDW and Soft- 



Works). Each has its advantages and disadvantages; what is 
right for you depends on your needs. If you are a 
hacker/experimenter or advanced user, Fast ST BASIC is fast 
and very powerful. If speed is very important and GEM is not, 
SoftWorks BASIC could fill your needs. If speed and some 
GEM support are necessary, GFA BASIC is it. If you are a be- 
ginner, need only limited GEM functions and/or lots of sup- 
port, the ST BASIC you already own may be ideal. If speed of 
final execution becomes a problem, that can be solved by the 
LDW BASIC Compiler 



GEM SUPPORT 



One of the most Important things to ST programmers is 
how well the language they use supports such GEM func- 
tions as windows, alert boxes and menus. After all, these 
program aspects give your creation the look and feel of a 
GEM-based application. To be perfectly honest, none of 
the languages I've surveyed here does as good a job of 
GEM support as, say, Personal Pascal. But let's look at what 
it takes to open a full-screen window with custom title and 
display an alert box. This will give you an idea of the qual- 
ity of GEM support you are getting with each BASIC 

First we'll look at ST BASIC Opening a custom window 
in ST BASIC is not something I want to even think about, 
so we'll just expand the output window to full screen: 

10 fullw 2:clearw 2:REM expand and clear the window 

20 POKE SYSTAB+24,l:a#=gb : REM change the title 

30 gmnn=PEEK(a#+8):POKE gintin,PEEK(systab+8) 

40 POKE gintin + 2,2:s#=gintin + 4 

50 DIM title$(20):title$="My window" 

60 POKE s#,VARPTR(title$):GEMSYS(105):POKE 

systab4-24,0 

70 DIM Alerttext$(50):icon=2:default=l:REM the alert 

box 

80 Alemext$=Str$(icon)+"!A Sample:Alert Boxl[OK:NOT 

OKI" 

90gintout==PEEK(a#+12):n#=PEEK(a#4-16):POKE 

gin tin, default 

100 POKE n#,VARPTR(Alerttext$) 

110GEMSYS(52):Choice=PEEK(gimout) 

The LDW Compiler uses the same code. 

Moving on to SoftWorks BASIC: 

Toolbox Appllmtjd 

Toolbox Grafliandle,wchar,hcharwbox,hbox,physhandle 
Toolbox WindGet,0,4,xdesk,ydesk,wdesk,hdesk 
DIM workin(10),workout(57),tide$(20):title$ = "My 



window" 

FOR i=0 TO 9:workin(i)=0:NEXT i 

workin(10)=2:handle=physhandle 

Toolbox Vopnvwk,workin,VARPTR(handle), workout 

Toolbox Windcreate,15,xdesk,ydesk,wdesk,hdesk, 

windhandle 

Toolbox Windset,windhandle,2,VARFTR(title$),return 

Toolbox Windopen,windhandle,xdesk,ydesk,wdesk,hdesk 

Toolbox VSFColoi;windhandle,0,setcolor 

Toolbox VSFinteriorwindhandle,2,setstyle 

Toolbox VSFstyle,windhandle,8,setstyle 

DIM temp(3):temp(0)=xdesk:temp(l)=ydesk 

temp(2)=xdesk+wdesk:temp(3)=ydesk+hdesk 

Toolbox Vbai>vindhandle,temp 

DIMAlertstring$(30):Alertstring$="[2][A 

sample: Alertbox!lYes:Nol" 

Toolbox Fonn Alert, 1, Alerts tring$,exitbutton 

Not too straightforward, is it? 

Fast ST BASIC makes quick work of the job: 

CLS: SETWINDCOORS OUTHANDLE,0,0, 

SCREENWIDTH.SCREENHEIGHT 

RESERVE mytide%,80: { mytitle% }$="Sample window" 

SETW1NDTITLE OUTHANDLE,mytitle% 

button=ALERT("12]EThis is a:sample alert]lyes:nol",l) 

As you can see, this last is pretty simple, and easy to read 
as well. 

Finally, there is GFA BASIC: 

Fullw 2 

Titlew 2, "Sample Window" 

Alert 2, "This is a:sample alen",l,"yes:no",button 

As you can see, for the GEM items GFA supports, usage is 
very simple- ■ 
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Finally, remember chat you are no[ locked in to using BA- 
SIC. There are many other languages available for the SX each 
with inherent advantages and disadvantages. Determine 
what's best for your needs and shop around. 1 hope my over- 
view of BASICS for the ST will help you make an informed 
choice. ■ 

IF YOU'D LIKE TO SEE MORE ARTICLES LIKE THIS ONE, 
CIRCLE 173 ON THE READER SERVICE CARD 

ST BASIC 
Atari Corporation 
1196 Borregas Avenue 
Sunnyvale, CA 94086 
(408) 745-2000 
Disk — Free 
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LDW Compiler 

Logical Design Works 

780 Montague Expressway #205 

San Jose, CA 95131 

(408) 435-1445 

Disk-S69.95 
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Fast ST BASIC 

Computer Concepts 

Gaddesden Place, Hemel Hempstead 

Hertfordshire, England HP26EX 

Cartridge— $139.95 
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SoftWorks BASIC 
SoftWorks Limited 
2994 N. Broadway 
Chicago, IL. 60657 
(312)975-4030 
Disk-$79.95 
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GFA BASIC 

MichTron Inc. 

576 South Telegraph 

Pontiac, Ml 48053 

(313) 334-5700 

Disk-$79.95 

Compiler— $79.95 
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MODULA-2 

the successor to Pascal 



face to GEM DOS. A 

ir tor greatly reducef 
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Desktop automates 
Edit/Compife/Link c 
FileSySlsm. Real InOi 
InOul, Strings. Storai 



■ 3d graphics and multi- lasting 
demos 

■ CODE statement lor assembly ci 

■ o'/O-paije manual 

■ Installs on Hard disk and RAM di 

■ No royallies or copy protection 



source code are nearly identical M 
supersel ol Pascal Professoi Nki 
:signed Modula-2 to replace Pascal. 



objects 

■ Open array paramete 
ARRAY OF REALS;) 

■ Eleganl type transfer 



MODULE Sieve: 

CONST Size = 8190: 

TYPE FlagFiange = KLStae); 

FlagSet = SET OF rii-.r^R.-in.-;-: 

VAR Flags: FlagSet; 

i; FlagRange; 

Prime, k. Count Hut CVHDINA. . 
BEGIN |'SS-,SR-,SA- '1 
FORIIer: = 1 TO 10 DO 
Count := 0; 

Flags:= FlagSet(); 1" empty sel ") 
FORi = 0TOSi;eDO 
" N Flags) THEN 



Prim. 



(i'2) -3;k 



:eDO 



END: 
END: 

END Si, ■■.-.- 



;i:= 1TO 1000 DO 



MODULE calc; 

VAR a.b.c; REAL; r>. I: CARDINAL. 
BEGIN ."ST-.SA-.SS-') 
n:= 5000: 

FOR i "O ". DO 



Regular Version 579.95 Developer ■.. Vorsiori ■Ihi'J.jj Can i: .'rclal Version S299.9- 
The regular version contains all [tic fi-aiures hsicd above. The developer's versioi 
Supplies an exlra uiskct:(: containing n symbol : ile decober - link and load fih 
disassemblers - a source file cross reference!' - sytibolic Co bugger - high levf 
Windows library Module - Pamdisk and l-'riri Spook:; sjiiicg files - Hespurci 



Liamplcs - Uiiny M;.i( 1 -: ; ■.'xa/Tipli; pi:j(;i;'iins !( 

advanced programming techniques 
GRID - Sophisticated niiilli-key die access m. 
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ESCAPE FROM 

THE DESKTOP 

I B M - TY P E COMMANDS 
FOR YOUR ST 



by Jeffrey R 



W i 



mired of the ease and convenience of your ST's 
mouse-and-menu interface? Wishing for the power 
and complexity of an IBM-style command line? 
Now you can have the best of both worlds! 
START's CLI is a desk accessory that gives you a 
command-line interpreter at the click of a mouse. 
It's fast, it's compact, and it's on your START disk. 



E; 
S 



ver since the Commodore Am- 
' iga appeared, I have envied 
I some of its features. In particu- 
lar, 1 appreciated the ability to create a 
command line and access disk and 
other utilities while in the middle of a 
program, and ! missed that convenience 
on my Atari ST. 

Desk accessory programs have ap- 
peared for the ST that allow access to 

MFiie CLI. ARC 
on your START disk 



disk utilities, but not much else-and 
the amount of memory they require is 
enormous in relation to what they actu- 
ally offer As a result, the cost in overall 
system performance for these utilities 
has been high. Dissatisfied with this sit- 
uation, I created a new desk accessory: 
the Atari Command Line interpreter 
(CLI). 

BY YOUR COMMAND 

A command line interpreter is some- 
thing of a throwback if you're ac- 



customed to a mouse-and-menu oper- 
ating system like GEM. With a CLI. the 
computer doesn't show you menus, 
windows and icons you can manipulate 
with a mouse Instead, it presents you 
only with a prompt that tells you what 
the current disk drive is; you must enter 
each command from the keyboard. In 
short, a CLI makes your computer act 
less like an ST and more like an 1BM- 
which some people prefer. 

The Atari CLI is a desk accessory 
that gives you access to many of the 
operating system's functions, including 
disk cataloguing, batch file processing, 
and a complete selection of file utilities. 
To perform a function, you just type a 
command, along with any parameters it 
may require. For example, to find out 
what's on a disk under GEM you use 
the mouse to double-click on the disk's 
icon. To do the same thing under the 
CLI, you can type the command DIR, 
which will list the contents of the cur- 
rent disk. 

The CLI has 58 internal commands, 
including several duplicates to shorten 
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the learning curve and make the com- 
mands more intuitive. In addition, you 
can run many programs from the CLI 
simply by typing a program's filename. 
A complete description of the internal 
commands and how to use them ap- 
pears at the end of this article; you can 
also get a list of the commands by typ- 
ing HELP at the prompt. 



Cli 

makes your ST 

act more like an IBM 

which some people 

prefer. 



Since it is written totally in assembly 
language, CLI takes up less than I0K of 
RAM when it's not being used. All the 
features are quick and efficient, and lit- 
tle overhead is required, as all functions 
tie directly into the operating system. 
While this utility program may not fill 
all your needs and desires, it should 
provide many of the features you're 
likely to need at a moment's notice on 
the ST 

USING CLI 

To GEM and all GEM-based programs, 
the CLI is an ordinary desk accessory. It 
is loaded automatically as pan of the 
normal boot process, and remains dor- 
mant until you select it irom the menu 
bar. Once selected, it immediately re- 
quests 33K for a CLI screen. If that 
much memory isn't available, an alert 
box informs you that there's insufficient 
memory for the CLI, and control im- 
mediately returns to the current appli- 
cation. Otherwise, CLI clears the mem- 
ory for the screen. Next, the program 



checks for a prompt configuration file 
on disk; if it finds one, the prompt is 
modified according to its contents. The 
CLI then checks for the autorun batch 
file, C:\CLI.BAT. If found, it is executed 
to completion. Finally, the program 
prompts you for input 

When you enter a command it is 
converted to uppercase, and checked 
against a table of internal commands. If 
the command is found, the associated 
routine is executed. If not, CLI treats the 
command as a filename (appending 
,PRG to it if the filename doesn't have 
an extension) and tries to run it as a 
program. In that case, any additional 
parameters on the command line are 
passed to the executed program in the 
command tail. 

When either the internal command 
or the external program has finished 
running, CLI will once again prompt 
you for input. This process continues 
until you leave the CLI with the 
BYE or QUIT command, at which point 
control returns to the current applica- 
tion. Only batch file execution modifies 
this chain of events. When a batch file 
is running, CLI gets its commands from 
the text file you specify in the BATCH 
command. 

External commands should be 
limited to TOS applications, as GEM ap- 
plications assume a certain environ- 
ment that may not exist when executed 
from the command line. Also, be careful 
when executing an external program 
while a GEM application is running. If 
you would like to execute a particular 
external program from within another 
program, first try the combination 
when there is no danger of losing long 
hours of work. While you'll rarely have 
problems starting the external program, 
the operating system can sometimes 
forget where to return in the original 
program. It's always safest to stay with 
internal commands while another pro- 
gram is running. If you want to add a 
routine to the list of internal commands, 
you'll find it's a very simple process that 
is fully documented in the source file. 



BATCH, BATCH, 
BATCH. . . 

During batch file processing, the CLI 
reads command lines from a text file 
that has been prepared specifically lor 
this purpose. The program opens the 
specified batch file, then reads com- 
mands from the file one at a time and 
executes each one as if it had been 
typed directly from the keyboard. 

Each BATCH command can take 
parameters to modify the commands in 
the batch file; you specify the 
parameters on the command line, right 
after the batch file's name Each parame- 
ter gets a number, and is inserted into 
the batch file's commands as they are 
executed. 

For example, suppose the batch file 
FOOBAR.BAT consists of three 
commands; 

SHAKE %3 

RATTLE %2 

ROLL %1 
If you use the command BATCH FOO- 
BAR MOE LARRY CURLY, CLI will exe- 
cute these three commands: 

SHAKE CURLY 

RATTLE LARRY 

ROLL MOE 



Cu 

takes up less than 

1 OK of RAM when it's 

not being used. 



The first parameter, MOE, replaces each 
occurrence of '%T in the batch file; the 
second parameter, LARRY, replaces each 
l %2', and the third parameter, CURLY, is 
inserted each time l %3' appears. 

You can specify up to nine 
parameters. The first nineteen charac- 
ters in each parameter are significant; ► 
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ESCAPE... 

any additional characters will automati- 
cally be truncated. If a parameter 
specified in the batch file has not been 
defined in the BATCH command line, 
nothing will be inserted into the com- 
mand. Batch files are fully recursive, 
and may be nested up to eight levels 
deep. If you need more levels, just reas- 
semble the CLI with more stack space 
allocated. During batch file processing, 
pressing the UNDO key will stop execu- 
tion of the current batch file and return 



you to the prompt. 

If the batch file CLI.BAT exists in the 
root directory of drive C, it will auto- 
matically be executed each time the CLI 
is requested from the menu bar. You 
can use this feature to create a custom- 
ized desk accessory or initialize the CLI 
to your favorite configuration. 

The CLI principle is simple, but I 
continue to be amazed at how useful 
this command line interpreter really is. 
Very few GEM-based programs have 



more disk utilities than the ability to 
delete a file, and some don't even have 
that much. If you've used command 
line-style operating systems before-or 
even if you haven't- it's very convenient 
and incredibly useful to have such a 
wide variety ot utilities available at your 
fingertips. Try it, and you'll see what 1 
mean! ■ 

IF YOU'D LIKE TO SEE MORE ARTI- 
CLES LIKE THIS ONE, CIRCLE 184 ON 
THE READER SERVICE CARD 
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Execute the specified batch file. See BATCH. 
BATCH 

Start batch file processing at the specified batch file, and save 
any specified parameters for insertion where designated in 
the batch file by '%n! See the article for more specifics on 
batch file processing. The file C:\CLI.BAT is the autorun 
batch file. If this file exits, batch file processing will automati- 
cally be invoked on this file when the CLI is requested from 
the menu bar. 



batch make 
testl test2 



BYE 



Begin batch file processing on the file 
MAKE. BAT, assigning %1 to 'testl' and %2 
to 'test2' 



Exit the CLI, return control to the current process. See EXIT. 

CAT 

Show a quick catalog of the specified path, or of the current 
path if no path is specified. A quick catalog includes direc- 
tory entries, as well as all normal files. Wildcards may be 
used to specify exactly what files should be displayed. During 
the display, any keypress will toggle a pause; the UNDO key 
will abort the catalog. 

cat '.asm Display a quick catalog of all files at the 

current path with the extension .ASM. 

CATALOG 

Show a long catalog of the specified path, or of the current 
path if no path is specified. This command is identical to the 
quick catalog command CAT, with the exception that files 
with a hidden or system attribute are also displayed. Addi- 
tionally, the long catalog displays information about memory 



usage on the disk which has been cataloged. 

catalog c: Display a long catalog of the root direc- 

tory of the disk in drive C.\ 

CDIR 

Change the current pathname to any valid GEM pathname. 
This command will not change the current drive, only the 
path associated with that drive 



cdtr . 



Back up one subdirectory in the path as- 
sociated with the current drive. 



CLS 

Clear the CLI screen. 

els The screen is cleared. 

COPY 

Copy the specified file to the specified location. Wildcards 
are permitted, but no prompting is done. If no destination is 
specified, the files will be copied to the currently active path. 

copy *.asm c: Copy all files with the extension .ASM at 

the currently active path to drive C:. 

DELETE 

Remove the specified file from the disk. Wildcards may be 
used, but no prompting is done. 

delete text.bak The file TEXTBAK is deleted from the 

current disk. 

DIR 

Display a short directory to the current output device. See 
CAT 
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DIRECTORY 

Display a long dn 
CATALOG. 



ctory to the current output device. See 



ECHO 

If no parameter has been specified, toggle the echo state for 
batch file processing. Otherwise, turn the toggle state ON or 
OFF as indicated. If echo has been disabled, the commands 
read from the batch file will not be shown on the screen. 

echo on Turn on echo. 

ERASE 

Delete the specified file from the disk. See DELETE. 

EXIT 

Exit the CLi, return control to the current process. 

exit GEM application is restored. 

FLASH 

Set the cursor Hash rate. If no parameter is specified, it will be 
interpreted as FLASH 0, or turn off cursor flash. If a numeri- 
cal parameter is passed, it will be used as the value for the 
flash, or the number of 60ths of a second (70ths on a mono- 
chrome monitor) before the cursor will flash. This command 
will change the cursor for all subsequent TOS applications 
that do not reset the flash rate. 



ll.i-ii 60 



Cursor flash is set to 1 / second. 



FORMAT 

Initialize a disk for use. The default setting is to initialize the 
disk in drive A:, single-sided, nine sector format. By adding 
several switches, these default settings may be changed. The 
switches are defined as follows: 

B Initialize the disk in drive B:, instead of the disk in 

drive A:. 
D Initialize the disk in double-sided format, instead ol 

single-sided format. 
T Initialize the disk in ten sector format, instead of 

nine sector format. 

Any switch desired is listed after the format command. Before 
the format is actually performed, all settings are displayed, 
along with a confirmation prompt. To start the format, the let- 
ter 'F must be pressed. The progress of the format is dis- 
played graphically. 



format bdt 



Initialize the disk in drive B:, double 
sided, ten sector format. 



FREE 

Show the amount of free memory available to a program. Both 
the amount available to an external command run from the 
CLI and the amount of memory available to the current proc- 
ess outside the CLI are displayed. 



fn 



Amount ol memory is displayed. 



HIDE 

Hide a file from GEM. This will prevent a file from being dis- 
played by either the desktop or the GEM input selector box. 
However, the file can still be read from and written to by GEM 
applications, provided the name is known. 

hide prompt.cnf Prevent GEM from seeing the file 
PROMPT.CNF. 

UNIT 

Format a disk for use See FORMAT. 

LOCK 

Prevent the specified file from being deleted or written to. 
Wildcards may be used. 

lock *.asm Lock all files with the extension .ASM at 

the current prefix. 

MEM 

Display the amount of free memory. See FREE. 

MKDIR 

Create the specified subdirectory or folder 

mkdir auto Creates the subdirectory AUTO. 

MODEM 

Make the RS-232 port the currently active output device. This 
is used to direct output to a modem. If no parameters are 
specified, all output is redirected until specifically redirected 
again. If anything is specified, the parameters are considered 
as an independent command line with the results being 
redirected to the RS-232 port. In this latter case, the output is 
only redirected to the RS-232 port for the duration of the 
command, alter which output direction will be restored to its 
former status. 



modem type 
readme.doc 



Send the contents of the file 
README.DOC to the RS-232 port. 



PATH 

Change the path for the currently active disk. See CD1R. 
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ESCAPE... 

PAUSE 

Wait for a keypress. This is used when a batch file should be 
temporarily suspended pending some action by the user. 

pause All processing is suspended until a key is 

pressed. 

PRINT 

Make the parallel port the currently active output device. This 
is used to direct output to a printer. If no parameters are 
specified, all output is redirected until specifically redirected 
again. If anything is specified, the parameters are considered 
as an independent command line with the results being 
redirected to the parallel port. In this latter case, the output is 
only redirected to the parallel port for the duration of the 
command, after which output direction will be restored to its 
former status. 



print 



All further output is done to the printer 
through the parallel port. 



PROMPT 

Configure the prompt according to the parameters specified. 
The new configuration is saved to drive C. Any of the VT52 
commands may be incoiporated, by using the '#" character in 
place of the escape. Certain additional commands are also ad- 
ded for convenience. The command list is as follows: 

## Insert the 'if character into the prompt. 

#A Move the cursor up one line. 

#B Move the cursor down one line. 

#C Move the cursor right one character 

#D Move the cursor left one character 

#E Clear the screen and home the cursor. 

#F Perform a line feed. 

#H Home the cursor 

#1 Cursor up one line with scroll. 

#1 Clear from cursor to end of screen. 

#K Clear from cursor to end of line. 

#L Insert line and scroll. 

#M Delete line and scroll. 

#P Display the currently active prefix. 

#S Show current date. 

#T Show current time. 

#Yrc Position the cursor to row r and column c. 

#br Set character color to color register r. 

#cr Set background color to color register r. 

#d Clear from top of screen to cursor. 

#e Enable cursor 

#f Disable cursor. 

#j Save cursor position. 

#k Move cursor to saved position. 



"I Clear line and move cursor to column 0. 

#o Clear from start of line to cursor 

#p Reverse video on. 

#q Reverse video off. 

#v Automatic overflow on. 

#w Automatic overflow off. 

prompt Prompt is configured and saved to drive 

#bl#P#b2>#b3 C. 

PROTECT 

Prevent the specified file irom being deleted or written to. See 
LOCK. 

QUIT 

Exit the CLI, return control to the current process. See EXIT 

REM 

Allows insertion of comments into a batch file Does nothing 
more than echo the parameters on the command line to the 
screen, if echo has not been turned off. 

rem hello Prints hello if echo is active. 

REMOVE 

Deletes the specified file from the disk. See DELETE. 

RENAME 

Renames the specified file to a new name. If a preceding path 
is required to locate the file to rename, a matching path must 
precede the new filename. 

rename wind.c Change the name of the file W1ND.C to 
window.c WINDOW.C. 

RMDIR 

Deletes the specified subdirectory or folder from the disk. An 
error will occur if the subdirectory is not empty. 

rmdir auto Removes the subdirectory AUTO from the 

disk. 

SCREEN 

Make the screen display the currently active output device. 
This is used to restore output direction after a MODEM or 
PRINTER command. 

screen All further output is done to the screen. 

SYSTEM 

Set the system flag of the specified file. Wildcards may be 
used. 
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system boot.sys Make the file BOOT.SYS a system file. 

TYPE 

Display the specified file to the currently active output device. 
This will dump the contents of a file to the screen, or to the 
printer or modem if the output has been redirected. If the 
UNDO key is pressed, the dump will be aborted. If any other 
key is pressed, the dump will be paused. Press any key to re- 
sume the dump. 

type readmedoc Print the contents of the file 

README.DOC (at the current prefix) to 
the current output device. 

UNHIDE 

Remove hidden status of the specified file. Wildcards are 
permitted. 

unhide Make the file PROMPT.CNF visible to 

prompt.cnf GEM. 

UNLOCK 

Remove write lock from the specified file. Wildcards are 
permitted. 

unlock safe.txt Clear the write protect Hag for the file 

SAFETXT. 

UNPROTECT 

Remove write lock from the specified file See UNLOCK. 

UNSYSTEM 

Remove system status of the specified file Wildcards are 
permitted. 

unsystem *sys Clear the system flag for all files ending 
with a .SYS extension. 

VERSION 

Show the starting prompt, with copyright information and 
version number. 

version Show version information. 

A: through P: 

Change the prefix to the specified drive. This is the only way 
to change the default drive. 

b: Make drive B: the current drive. ■ 



CLIPBOARD 




ou say you've finally gotten windows open- 
ing and closing properly on the desktop. 
but can't seem to get any text printed in- 
side one? Normally when you use C printfQ prints text to 
the screen. However, the STs OS has two distinctly different 
sections handling text input and output. When printing text 
inside windows, remember the windows are GEM based, so 
you'll need to use the GEM-based text output command v_ 
gtextQ When printing strings through TOS, however, 
printfQ works fine There's also CconwsQ, which operates 
closely to printfQ, and Bconout( ), which will output in- 
dividual characters. 




you plan to open up your 520ST, to up- 
grade memory or make other hardware 
changes, be warned! Not only will you void 
your warranty, but you have a chance of damaging your ST's 
plastic case. There are six screws which hold the ST case to- 
gether: three along the back and three along the front. The 
front screws are slightly smaller than the rear ones. If you 
screw the rear screws into the front holes, there is a good 
chance the screw points will pop out of the (op of the ST case, 
here your hands rest while you type. Be careful! 




eed to detect which Function Key you've 
hit? How about detecting if the [RETURN! 
key or the IENTER1 key was selected? Easy 
If you're not using GEM, use Bconstat(2) and Bconin(2). Bco- 
nin(2) will return a 32 bit value, with an ASCII value in the 
low 8 bits of the lower 16 bits and a scancode in the low 8 
bits of the upper 16 bits. In case the ASCII value is identical 
for different keystrokes, like [RETURN!, IENTER1 and ~ M, the 
scan code will distinguish them. Function keys have an ASCII 
value of zero, but have unique scan codes, which may be 
found in your GEM documentation. 

(Editor's note: Got an ST trick or tip to share? Send it to 
START, attention CLIPBOARD.) ■ 
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ST-Replay 
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ST-Rephy is an 
exciting new 
program that 
allows you to 
digitize and 
replay various 
sounds, including 
musical 
instruments, 

television programs, even your own voice. These sounds 
can be played back through your monitor, T.V., or a 
stereo system. ST-Replay also includes ST-ECHO, a 
program to allow special sound effects. 



$199.95 

Musix 32 
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IJ-H'H'1WH-H-H:H-I Musix 32 is the 
new music 
program that 
allows you to 
pick notes and 
rests from a 
menu, then drag 
them with the 
mouse to an 
onscreen staff. Once you have created your 
composition, you can immediately play it back. Music 
writing and editing has never been simpler! You can 
compose for one to three voices, and all compositions 
can be saved to disk, or printed on a dot matrix printer. 

$59.95 



For more information on these exciting new 



music programs, contact: 



INirfifron 

576 S. Telegraph, Pontiac, Ml 48053 
Orders and Information (313) 334-5700 
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DigiDrum 




Turn your Atari 
ST into a sizzling, 
digitized drum 
machine with 
DigiDrum. 
From the cool 
syncopated beat 
of a Jazz 
improvisation to 
the martial flare of a staccato snare, you can experience 
it all, digitally, with this amazing program. It allows 
you to store up to 99 patterns which can have from 4 to 32 
beats per patterns. Also, DigiDrum is compatible with 
the sound digitizer, ST-Replay. 

$39.95 



Super Conductor 



Presenting Super 
Conductor, the 
professional 16 
track MIDI 
sequencing 
package that no 
musician should 
be without. 
Loaded with 




powerful features, Super Conductor can quantize (auto 
correct), filter, transpose, edit, and mix music played 
through a synthesizer. Comprehensive editing gives 
musicians precise control over their performances, 
including the alteration of controllers such as volume 
pedal, pitch bend, and modulation settings. 
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$79.95 
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GENESIS 



The 3D Molecular Modeler ■ ' 
by Scott Legrand 
The atoms of life. , . carbon 
. . . nitrogen . . . hydrogen 
. . . oxygen . , . phosphorus 

This is the stuff we're made 
of. But until now, only re- 
search scientists in large 
universities could actually 
image the building blocks of 
matter, 

Imagine creating the basic 
elements yourself, then watch- 
ing as they come to life. And 
with a pair of STERE0r/EK 
glasses, this miraculous proc- 
ess unfolds in 3D stereoscopic 
depth. 

Using GENESIS and your 
mouse, you can: 



"■■ load and display amino 
acids, hydrocarbons,- and 
sugars 

■ create your own molecules 
onscreen or build them with 
data from pre-stored libraries 

Rotate 3D molecules on any 
axis— X, Y, or Z, using real- 
time control. In stereo, hex- 
agonal carbon rings and deli- 
cate fingers of hydrogen burst 
right out of your monitor. 
With two molecules onscreen, 
you may: 

■ create your own rules for 
molecular bonding, then ani- 
mate the chemidal reaction be- 
tween them j 

■ derive the new empirical 
formula and j(rint hardcopy 



data for reference "■■■ 
GENESIS.-offers the same.type 
of iconic control panel arid In- 
tuitive human interface pi- 
oneered on the Atari ST with 
CAD-3D 2.0. 

Three different display modes 
for every imaging need: 

1) STEREOTEK LCS glasses. 

2) Red/blue anaglyphic 
glasses, . 

: 3) No-glasses (monoscopic). 
And with data provided on the 
program disk, you can create 
virtually any known molecule 
using the on-line periodic table N 
of elements. 
GENESIS 

STD239 $79,95 
(requires one-megabyte RAM) 
Available June 



THE CYBER STUDIO" (2-pmgram set) s 

The first affordable integrated 3D video production workstation. 




Tom Hudson's STEREO CAD-3D 2.0 

Supports (optional) STEREOTEK3D Glasses 
Hidden within your Atari ST is a professional 3D workstation. A 
3D design system that is intuitive— yet powerful enough for 
professional artists, advertising agencies, or design firms. 

We've taken every suggestion from graphics professionals who 
loved version 1.0, but wanted more designing power and speed. 
And then we made version 2.0 an open -architecture system, so 
that any programmer can easily write custom applications for 
CAD-3D 2.0 that run as desk accessories: motion control 
choreography, advanced rendering/ray tracing, finite element 
analysis, texture mapping, custom modeling tools. . . There's no 
limit. CAD-3D 2.0 will never become obsolete. 

Let your creativity soar with all these new features: 

■ Icon control panel — fast, intuitive interface 

■ All new, DEGAS-style color design system permits custom-color 
lines, edges and backgrounds, multi-colored objects 

■ Real-time display mode for instant response (uses 3D math de- 
veloped by Jez San for Starglider'") 

■ Supports (optional) STEREOTEK 3D glasses for 3D viewing 

■ Dimensioning (feet/inches or meters/centimeters) 

■ Graphic lighting control — drag lights anywhere 

■ GDOS output supports laser and dot matrix printers 

■ Load/Save 2D object templates (from other CADD systems) 

■ Customized rendering system plus Z-buffer accuracy 

■ User-selectable pivot points for articulated rotations 

■ Enhanced Spin, Extrude, and Join tools 

■ Load DEGAS pics into CAD-3D background 



/Intic's CAD-3D is one of the best programs I've 
seen for the Atari or anything else." 
—Jerry Pournelle 
Byte Magazine 
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Mark Kimball's CYBERMATE" 

Supports (optional) STEREOTEK 3D Glasses 
The CAD-3D Animation/Editing language 
You need powerful tools to produce a professional 3D digital ani- 
mation. Important things like editing, special effects, and sound 
are critical elements in a high-quality presentation. CYBERMATE 
is a full-featured animation language that gives you control over: 

■ Sequence looping, cuts, fades, wipes & dissolves 

■ Color slutting 

■ Sound effects (created with the G.I. ST.™ editor, on pg. 11) 

■ Acceleration & deceleration 

■ Title generation and text display 

CYBERMATE features editing power comparible to a Hollywood 
post-production studio, plus full programm ability. At your finger- 
tips is the most efficient real-time playback system for 3D 
graphics ever on a microcomputer. And it's fast! 

How does it work? At the heart of CYBERMATE lies our exclu- 
sive delta compression format, which transforms your one-meg 
ST into a TEN-MEGABYTE frame buffer. Up to a thousand frames 
of animation can be held in RAM at once. And because it's a real 
programming language, CYBERMATE can adapt to new technolo- 
gies, like the new digital video tape recorders from Japan, RGB- 
to-NTSC converters, MIDI, and SMPTE time code. 

THE CYBER STUDIO SttfQftlei" Firebird Software 

STEREO CA0-3D 2.0 plus CYBEHMATE DEGflS " Bslleries lnclude(1 

2-disk set (requires one-megabyte RAM) 
Upgrade from CAD-3D 1.0 for only $60 (plus original disk and $5 shipping) 

ST0236 $89.95 



A remarkably powerful modeling system." 
— Computer Graphics World 

The Original. . . 

Tom Hudson's CA0-3D "" 1.0 

520ST-compatible 

If you own a 520ST and are interested in computer graphics, 

many of the features of CAD-3D 2.0 are included in this 

original version — you even get a basic animation system. 

(requires 512K RAM) 

STG214 S49.95 
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CTBERSCAPE® 

A 3-D "feature film" on disk 
by Darrel Anderson 
Skim the fantastic, 3-dimen- 
sional terrain of the mind! 
Metamorphosing metaJJatons 
and transforming tubular time 
slots! This full-color, animated 
feature was created by profes- 
sional artist Darrel Anderson, 
to show what can be done with 
CYBERMATE— The CAD-3D 
Animator. An incredible tour 
de force of computer graphic 
power, this demo is a guaran- 
teed auto-lobotomy of the 
very first order! 
CYBERSCAPE DS 
(1 double-sided disk) 
SB0104 $10.00 

CYBERSCAPE SS 

(2 single-sided disks) 
SB0105 $12.00 
(Both versions require 
1 megabyte RAM) 



Now you can write the next 

hit 3D program! 

3D DEVELOPERS DISK 

For CAD-3D 2.0 
by Tom Hudson 
While Tom was rewriting G\D- 
3D, he quickly realized that it 
was impossible to add every- 
thing and still release a product 
in this century. Plus, who 
wanted CAD software that re- 
quired a 4 megabyte machine? 
So he opened up the system — 
by providing a programmers 
'pipeline' through desk acces- 
sories. 

Opportunity Knocks! 
The 3D DEVELOPERS DISK 
clearly explains to programmers 
and developers how to access 
the pipeline. Included on the 
disk are full- featured example 
source and object code exam- 
ples, plus detailed instructions 
by Tom Hudson showing you 
how to hook into CAD-3D 2.0. 
Create your own 3D applica- 
tions — with no knowledge of 
3D math. There's no licensing 
fee required. 

(Requires CAD-3D 2.0) 
(works with most popular ST C's 
plus machine language) 
30 DEVELOPERS DISK 
ST0244 $29.95 
AVAILABLE JUNE 



3D-F0NT PACKAGE 

by Tom Hudson 
Design your own 3D greeting 
cards, signs, logos, and letter- 
heads with CAD-3D. Or create 
sophisticated 3D animated title 
sequences for your home videos. 
At the heart of this packed 
disk is Tom Hudson's new 
SUPER EXTRUDER TOOL. With 
it, you can create new kinds 
of complex, multicolored 3D 
objects that can't be built 
with CAD-3D alone. Plus, it 



doubles as a 3D FONT EDITOR, 
and Tom has built two incred- 
ible fonts just for you (serif 
and sans-serif, upper and 
lower case — over 250K 
of fonts!). 




(requires CAD-3D) 
3D-FONT PACKAGE 
ST0224 $24.95 



PLOTTER AND PRINTER 
DRIVERS 

ftefcfWW 3D drawings on a 
high-resolution pen plotter 
for a truly professional look! 
Supports Hewlett-Packard 
(and HP compatible) plotters. 
Multi-plots on a single page- 
best fit system. 



(requires CAD-3D) 
PLOTTER DRIVERS 
ST0225 $24.95 
Also, dot matrix printers 
supported: GEMINI/STAR, KPSON, 
OKIDATA, IBM, COLOR (Radio 
Shack, Epson, Canon), NEC, 
PANASONIC. C-ITOil, and more. 



THE CAD-3D DESIGN DISK LIBRARY 

Darrel Anderson and Richard Berry 

YOUR FOUNDATION FOR THE BEST IN CAD-3D ART 



tfill 



HUMAN DESIGN DISK 
Populate the CAD-3D Universe. 
Bring life to your CAD-3D crea- 
tions with the CAD-3D HUMAN 
DESIGN DISK. Complete modu- 
lar male and female prototypes, 
in skeletal and surface anatomy 
forms, are included. A variety 
of complex heads and hands 
add detail and realism to your 
figures. Modify your figures to 
create the Infinite variety of the 
human form, pose your 
figures, detail the images with 
any popular paint program, or 

ARCHITECTURAL DESIGN 
DISK ™ 

Create CAD-3D renderings of 
your Dream House or build an 
entire CAD-City from the 
ground up. Component parts 
including: Doors, Windows, 
Arches, Roofs, Walls, Stairways, 
and a wide variety of arcititec- 
tural accoutrements. Create 
your own CAD structures and 
populate them with HUMAN 
DESIGN figures. Build "sets" 
for your CYBERMATE animated 
movies, 

NOTE: The ARCHITECTURAL 
DESIGN DISK can be used to 

FUTURE DESIGN DISK 

Get a fast start on your three- 
dimensional explorations with 
the CAD-3D FUTURE DESIGN 
DISK. Everything you need to 
create SPACECRAFT, STATIONS, 
BASES, VEHICLES, ROBOT'S, and 
ANDROIDS. Model your future 
then populate it with androids 
and CAD-People. Bring it to life 
with CYBERMATE; detail #) 
it with any popular 
paint program, 
Includes: 

■ Blueprints 

■ Complete models 

■ Component parts 




bring them to life with the 
CYBERMATE Animation System. 
Includes: 

■ Blueprints 

■ Tips on the dynamics of hu- 
man anatomy. 




visualize and render real world 
architecture. It is not intended 
for use as an architectural engi- 
neering tool. Includes: 

■ Blueprints 

■ Complete Models 

■ Design Tips 




■ Construction tips 

-HUMAN DESIGN DISK 
ST0242 $29.95 
'ARCHITECTURAL DESIGN DISK 
ST0243 $29.95 
FUTURE DESIGN DISK 
ST0232 $24.95 
(Ail Design disks require CAD-3D) 
'AVAILABLE JUNE 
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■ LC Technologies. 



True stereoscopic 3D graphics for your Atari ST. 

STEREOTEK 3D GLASSES 

by LC Technologies 




Put on the STEREOTEK glasses and jump into a new universe. 
Discover a magical world that yon always knew existed. That ex- 
tra dimension — DEPTH. Now you can add depth to your com- 
puter graphics with the STEREOTEK Liquid Crystal glasses. Solid, 
realistic, 3D images you want to reach out and touch. STEREO- 
TEK glasses plug into your ATARI ST cartridge port to provide ab- 
solutely realistic 3D graphics in full color or hi-res monochrome. 

NOW! AVAILABLE FOR USE WITH STEREOTEK GLASSES . j 

whom you must play inter- 
stellar poker. LCS WANDERER 
is a complex, multimodular 
program — really several 
games in one. Journey from 
the dogfights in the Space 
sectors to the interstellar 
poker strategies, from the 
Battlezone-style of the Plane- 
tary sectors to the stereo tunnel 
of the Black holes, and Umbo . . . 
well, there's always Limbo. 

The liquid-crystal clarity of 
the StereoTek glasses trans- 
forms LCS WANDERER into a 
multi-colored micro universe 
within your monitor. Includes 
a completely redesigned solid- 
surface cockpit, full 16-color 
displays, and reduced eye- 
fatigue compared to the 
original red/hlue version. 
(Requires color monitor and 
StereoTek glasses) 
LCS WANDERER 
ST0238 S39.95 

Battlezone™ Atari Corp. 



LCS WANDERER™ 

by Pyramide Software 
Deep space has never been 
so real! 

LCS WANDERER is the first ST 
game designed for full-depth 
stereo. Written in France, but 
set in outer space, this 
stunning arcade adventure 
transports you through 
galactic Space sectors, Black 
holes, and Limbo. Startlingly 
realistic, stereo point-of-view 
animation puts you in the 
cockpit as you swoop and dive 
through star fields while 
dodging enemy craft. 

This is no ordinary space 
shoot-em-up. The bizarre, 
complex plot involves the 
ruthless kidnapping of every 
cat on earth. As you wander 
through space, collecting 
purloined pussycats, you run 
across the Heads of State of 
the Planetary sectors with 
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Your STEREOTEK depth-view system includes; 

■ One pair electronic Liquid Crystal Shutter glasses with four-foot 
cable (can be comfortably worn over eyeglasses). 

■ ST cartridge interface unit — supports two sets of glasses (sec- 
ond set optional). 

■ DEGAS Elite Stereo Desk Accessory. 

■ Stereo CAD-3D animation and stereo slide show by Tbm 
Hudson. 

■ For programmers: Complete developer's instructions plus 
sourcecode for adding stereo to your own programs. (C or GFA 
BASIC) 

The secret to full-color stereo images on a computer screen is 
« electronic Liquid Crystal Shutter (LCS) glasses. Two optical shut- 
ters in eyeglass frames are connected electronically to the ST. Ev- 
il ery time the ST screen refreshes (60h*z/color, 70hz/mono), one 
I shutter closes and the other opens. The monitor displays alter- 
| nating right and left eye views synchronized with the shutters. 
| The alternating views appear faster than the eye can see, and 
g your brain translates the normally flat monitor image into one of 

startlingly realistic depth. 

STEREOTEK 3D SYSTEM 

TH9020 $149.95 

ADD-ON GLASSES ONLY 

TH9021 $99.95 

STEREOTEK 3D SYSTEM 

Manufacturer's Sugg. List: S189.95 

Catalog Price: You pay only 5149.95 



LC Technologies is a venture of 

Tektronix, Inc. 




$5,000 CONTEST 



Antic and LC Technologies are co-sponsoring a competition 
to search for the MOST INNOVATIVE STEREO APPLICATION 
PROGRAM. We're going to pay 55,000 in cash {advance against 
royalties)- for the winner, plus a continuing royalty upon 
publication here in The Catalog. 

For an official entry blank and competition details, write to 
STEREO COMPETITION; The Catalog, 544 Second St. , 
San Francisco, CA 94107, or call (415) 957-0886. 





NOW! A PROFESSIONAL FLIGHT PLANNER FOR THE ST! 
THE NAVIGATOR" 

by Scott D. Stephenson 0.WI 



i 



■ Works with MAPS AND LEGENDS 
Sometimes, you really need to know exactly where you're going. 
Have you ever wondered, while hoarding your plane, how the 
pilot will find his way to your destination? The answer is naviga- 
tion. The pilot follows a detailed flight plan created by his 
navigator. 

Now, accurate computerized navigational planning is available 
on the Atari ST. THE NAVIGATOR is a professional, automated 
flight planner created specifically for the ST by professional navi- 



gator Scott D. Stephenson. Private pilots, military pilots, naviga- 
tors (ocean-going as well as air), and commercial operators can 
use this amazing program to create accurate, detailed flight plans. 

Amateurs, arm-chair flyers, teachers and students of naviga- 
tional theory can discover how the professional navigator plans 
his flight, compensates for wind direction, establishes waypoints, 
and calculates times and distances. And we've included a special 
MAPS AND LEGENDS overlay function which creates custom map 
overlays, graphically displaying your flight paths. 
- PRIVATE PILOTS: You'll love THE NAVIGATOR'S printed flight 
plan and extensive ICAO waypoint database, 

■ ARMCHAIR PILOTS: Generate your own flight plans for sub- 
Logic's FLIGHT SIMULATOR II. 

■ TEACHERS: Show your students the rudiments of navigation. 
Use THE NAVIGATOR plus MAPS AND LEGENDS to measure the 
earth! 

■ SAILERS: Plan for currents or winds — taking fuel flows and 
times Into consideration. 

■ THE NAVIGATOR comes complete with these databases: Euro- 
pean ICAO, Asian ICAO, and US ICAO. 

TWO PROGRAMS IN ONE! 

Included with THE NAVIGATOR is THE NAVIGATION TOOLKIT a 
bonus program of computer navigation tools which performs 
sophisticated data management operations on your waypoint 
databases. Create new data files or modify existing files using its 
advanced random-search technique. 
THE NAVIGATOR 
ST0Z45 S49.95 
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THE WORLD ON A DISK. 
MAPS FOR EVERYBODY! 
MAPS AND LEGENDS - 
The Cartographer 

Enhanced Version 
Supports (optional) 
StereoTek Glasses 
by Harry Koons and 
David Chenette 
Hold on a second. Now that 
you've word-processed, 
spreadsheeted, databased 
and telecommunicated with 
your Atari ST, aren't you 
looking for something 
different? 

How about Cartography? 
Until now, mapmaking has 
been a unique art mastered 
by only a few talented people. 
Not anymore. With MAPS AND 
LEGENDS, your Atari ST 
becomes a personal desktop 
cartography system. 

Show your children exactly 



what the world looks like — 
with or without political 
boundaries. And in STEREO, 
the world globes appear 




to be floating in front of your 
monitor. Or print an impres- 
sive custom map to go with 
your travel itinerary. We use 
MAPS AND LEGENDS all the 
time at the office for sales and 
marketing maps. And since it's 
based on the GEM interface, 
it's GEM-easy to use! 
MAPS AND LEGENDS 3.0 
ST0202 $34.95^ 
(upgrade is $15) 
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LETS-GET-TECHN1CAL BOX 
Packed with features, including: STEREO COMPATIBILITY, 
BUILT-IN 9000-COORDLNATE DATABASE, 11 DIFFERENT 
MAP PERSPECTIVES, PLOTTING FROM ANY ALTITUDE, 
WORKS IN ALL 3 SCREEN MODES, BUILT-IN PAINT SYSTEM 
(and compatible with DEGAS and NEO), MULTI-FONT 
LABELLER, CUSTOM OVERLAY PLOTTER (create your own 
maps — build your own map databases), AUTO-LOCATE 
MODE (reads coordinates, distance and bearing from maps) 
and so many more that we don't have room to list them all. 



DATAMAP COLLECTION I 

Expand Your Maps and 
Legends Database! 

NATIONAL POLITICAL 
BOUNDARIES 

Europe, Latin America, 
S. America, Asia, Africa 



PROVINCIAL 
BOUNDARIES 

Australia, Canada, China, 

U.S.S.R. 

(requires Maps and Legends 

2.0 or greater) 

DATAMAPS 

ST0227 $24.95 



PLUS HISTORICAL MAPS AND MORE! 
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The GEM Database by the Authors of DBMASTER ONE 



THE NEXT STEP IN DATA- 
BASES, BY THE AUTHORS OF 
DB MASTER ONE" 7 
BASE-TWO" 
Dan Matejka 
and Stanley Crane 
It's no fun re-learning your 
database commands every time 
you boot it up. And those sim- 
plistic "filecard" databases just 
don't have the power to do the 
job. Or, maybe you've just 
created your custom database, 
entered 5,000 records, and 
now you want to print a re- 
port. . . Good luck. You need 
a degree in programming just 
to get some decently formatted 
hardcopy! 

Dan Matejka and Stanley 
Crane have eight combined 
years of experience writing 
databases on computers rang- 
ing from the IBM PC to the 
Apple Macintosh. And their 
databases range in complexity 
from the extremely powerful 
and complex IBM PC DB MAS- 
TER to the familiar, introduc- 
tory DB MASTER ONE on the 
Atari ST. They've watched the 
ST database market grow — 
and they've spotted a gap: Un- 
til now, ST databases have 
been either too simple, or too 
complex. Until now, ST 
owners were limited to easy- 
to-use, inflexible "mailing 
lists," or involved, program- 
mable "throw-backs" to the 



800-443-0100, 
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(Continental U.S. and Hawaii) 
Visa/MC Only 
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CP/M or MS-DOS world. Until 
now, there was no intuitive, 
yet powerful database featuring 
an adaptable report generator. 
Until now. 

BASE-TWO fdls the gap. En- 
tirely GEM-operated, DB 
MASTER-ONE owners will find 
it familiar, yet far more 
powerful. Look over some of 
the features and see if it solves 
your problem: 

■ Variable field types: 

■ Implicit (default) 

■ Alpha 

■ Numeric 

■ Date (calculable) 

■ Formula 

■ Formula fields automatically 
calculate results from several 
fields in same record 

■ Adjustable numeric decimal 
placement 

■ Re-edit database at any time 
without loosing data 

■ User-definable .DIF file crea- 
tion for software compatibility 
(with A-CHART, for example) 
- DB MASTER-ONE conversion 
program 

■ On-line Help screens 

■ Optional mouse or keyboard 
control 

■ 64 character label length 

■ 100 fields per record 

■ Multi-level Search and Sort 

■ Totally RAM-hased for instant 
action 

■ Format disks from within 
program 



The intuitive BASE-TWO 
Report generator includes: 

■ Multi-line field word-wrap; 
screen and printer 

■ Completely adustable label or 
column-format report 



■ Place "comment" text 
anywhere 

■ Customize with printer con- 
trol codes 

■ 'Soft" field borders for auto- 
field truncation 





INSTANTANEOUS SORTING! 




size 


# records 




sort time 


512K 


5,000 




5.1 sec 


I Meg 


10,000 




9.7 sec 


2 Meg 


20,000 




19-2 sec 


4 Meg 


50,000 




46.1 sec 




Using a sample eight-field 


mailing list 





■ Optional, automatic date, 
time, and page numbering 

■ Print reports to screen, 
printer, or ASCII disk file tor 
word-processor editing 

* Optional subtotal printout 

■ Adjust number of records 
per page 

■ Double-line report headers 



■ Single-sheet or continuous 
feed option 

■ Store 10 custom reports for 
each file 

■ Up to 100 unique fields per 
report 



BASE-TWO 
ST0246 S59.95 
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PHA$AR IS THE STANDARD BY WHICH OTHER FINANCIAL PACKAGES WILL BE MEASURED 

IBM AND AMIGA USERS SAY: 



the first home accounting package I have found in five 
years that is actually usable." 
—Mark Baldwin, Littleton, CO 



I am enjoying your tutorial almost as much as I admire 
the power and versatility of the software itself." 
—Joe Joyce, Huntington, VT 



PHASAR 



Professional Home Accounting System and Register 

by Marksman Technology 



WHAT PHASAR IS: A friendly, 
GEM-based, single-entry 
accounting system that will 
make your life easier. PHASAR 
is fast, sophisticated and 
contains the best interface 
programming design we've 
seen in any ST applications 
program. 

GENERAL FEATURES 

■ 130 expense/income 
categories 

■ 40 accounts (VISA, 
checking, etc.) 

■ Up to 500 transactions 
per month 

■ Custom check printing 

■ A.I. parser predicts input, 
minimizes typing 

■ Instant help messages with 
right mouse button 

■ Relational design integrates 
financial data 

TRANSACTIONS 

■ Automatic transfers 
between accounts 

■ Split- category transactions 

■ Create transaction macros 
for repetitive entries 

■ Point -and- type 
spreadsheet- style relational 
summary update 

FINANCIAL ANALYSIS 

■ Easy budget setup and 
maintenance 

■ Analyze loan/savings plans 

■ Display multiple loans 
simultaneously for easy 
comparison 




DATE/ADDRESS 
ORGANIZER 

■ Store up to 250 names, 
addresses and phone 
numbers 

■ Integrated scheduler stores 
special occasions 

■ Display calendar with 
highlighted special 
occasions 

■ Optional auto- alert reminds 
you of important events 

RECONCILIATION 

■ Display outstanding 
transactions for any 
account 

■ Confirm transactions with 

single keystroke 



REPORTS 

■ Clearly formatted printed 
reports include: 

• Account Summaries 

• Category Summaries 

• Net Worth Statement 

• Tax Calculations 

• And more . . , 

■ Display or print total 
income/expenses, monthly 
or year-to-date 

■ Sort categories in any order 

■ Built in data graphing 

- Compatible with A- CHART 



TAX 

■ Design your own tax 
forms — never out of date 

■ Calculate tax IiabiUty in less 
than one minute 

■ Project tax liability at any 
time 

PHA$AR 

ST0237 $89.95 
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BYTE TESTS SHOW A-CALC ALMOST W\CE AS FAST AS 
MICROSOFT MULTIPLAN ON THE MAC PLUS! 
A-CALC PRIME " by Kuma 

Kuma Computers, Ltd. UK 

That's right! In the February 1987 review of the Atari 1040ST, 
BYTE magazine selected A-CALC 1.0 to test the Atari against the 
Amiga and the Macintosh Plus. On recalculation of a 25x25 cell 
spreadsheet, A-CALC was the clear winner at 4.7 seconds, com- 
pared to 7.5 on the Mac Plus, and 6.5 on the Amiga (using Lat- 
tice Unicalc). 

And now, you can have all the speed of the original GEM- 
based spreadsheet plus the powerhouse features of the next 
generation: A-CALC PRIME — it blows away the competition. 



Desk File Options Status Printer Global 




Features that made the original A-CALC 1.0 the easiest- to-use 
spreadsheet ever: 

■ Up to five windows open at once 

■ WIDE-VIEW option to see 50 percent more of your worksheet 
at once 

■ SEARCH for character strings 

■ Powerful PRINTER FORMATTING commands 




this is the easiest to use spreadsheet that I've ever seen." 
— W. Krieger 
Computer Shopper Magazine 



■ .DIE file compatibility 

■ Exclusive A-CHART compatibility 

■ Sparse-matrix design maximizes available RAM 

And now, PRIME adds dozens of special features: 

■ Row and column lock. 

■ Conditional expressions (IF, THEN, ELSE, etc.) 

■ MACROS 

■ Labels 

■ 8192 tows x 256 columns 

• Color/pattern coding of formula, text, value, etc. 

■ SORT and FIND 

■ Trig functions 

■ Sideways printing (for Epson compatibles) 

■ High-speed SMOOTH screen updating 

■ Complete printer control from within the spreadsheet 

■ Password-protected cells (hide and unhide) 

■ Additional ease-of-use features: 

■ Off-screen scrolling with the mouse 

■ Out-of-the-way convenient edit window 

■ Cell and range reference by pointing with the mouse 

(even reference cells in inactive windows!) 

■ Ten clipboards 

■ Illustrated manual and on-disk examples 

In short, PRIME gives you premium spreadsheet power for the 
rock-bottom price of $59*95. And, for A-CALC 1.0 owners, the 
upgrade is only $20.00 (plus S5.00 shipping. Enclose your origi- 
nal ver. 1 disk). 
A-CALC PRIME 
ST0235 $59.95 



Make your next presentation the one they remember. 
A-CHART " by Kuma 
Kuma Computers, Ltd. UK 

When was the last time you were excited about your spread- 
sheet? A-CHART makes working with figures fun and intuitive. 

A-CHART automatically turns your A-CALC (or A-CALC PRIME) 
spreadsheets into beautiful graphs that are DEGAS-compatible. 
And, if you don't have a spreadsheet, A-CHART's built-in editor 
will help you organize those numbers into a super-sharp presen- A- 
tation. 

View your data in eight different chart styles — change 
styles instantly with one mouse click. Drag and size multiple 




CEREAL SALES 



i :|i r [■■ JTH 
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DEGAS ENHANCED 



CHART DEGAS ENHANCED 

charts in each window, define your own fill patterns and 
line styles. The flexibility of the graphic presentation of your 
numbers will give you an entirely new perspective on your 
business or home budget. And A-CHART grows as you do, 
with the capability of storing up to 50,000 data points in a 5UK 
machine and 150,000 datapoint in a I meg machine. Full statis- 
tics menu for detailed analysis includes Mean, Median, Vari- 
ance, Standard Deviation, Skewness, T-test, F-test, and much 
more. 
A-CHART 

ST0230 $39.95 
Epson-compalible from A-CHART. 
Multi-printer compatible from DEGAS. 
File compatible with BASE-TWO, PHASAR, and A-CALC PRIME 
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iLASH is my #7 choice 
on the Atari ST." 
—Ron Luks, Founder of 
CompuServe's SIG'Atari 
and Atari Developers 
Forum. 



THE MOST POPULAR 
TERMINAL PROGRAM FOR 
THE ATARI ST. 

FLASH™ 

Version 1.1 
by Joe Chiazzese and 
Alan Page 

If you own a modem, you 
should be using FLASH. Why? 
Because FLASH is the best. It 
will simplify your online time 
and make telecommunicating 
more enjoyable and less 
expensive. 

TOTALLY PROGRAMMABLE 
PLUSBITLT-IN 
WORD PROCESSING 
Imagine turning on your ST 
and, with one click from the 
GEM Desktop, beginning an 
online session on your 
favorite BBS. Watch FLASH 




dial the number, log on, and 
automatically browse 
through the most recent 
messages or files. Then, edit 
some email in the built-in 
message editor, and upload 
it right from the capture 
buffer. Instantly! It's your 
personal telecom droid. So 
programmable that you have 
total control, and so GEM- 
intuitive that you fee! right at 
home the first day you use it. 
No wonder FLASH is the most 
popular Atari terminal 
program of all time. 

TERMINAL EMULATION 
PLUS BULLETPROOF 
FILE TRANSFERS 
Of course, FLASH has a barrel 
full of terminal-emulation 
features, such as DEC VT1007 
VT52 and CompuServe Vidtex 
graphics, so you can use it 
with every mini or main- 
frame editor. And talk about 
FLASH COMMAND CARDS 



bulletproof file transfers! It's 
got the most reliable Xmodem 
around — never lose a file 
during transmission again! 

PACKED WITH FEATURES! 
Here are just a few of the most 
useful features. Shop around 
and see if any other terminal 
program can even come close! 

■ Built-in GExM word 
processor with cut & paste 

■ Programmable "script" 
language (70 commands) 

■ Mainframe terminal 
emulation 

■ Xmodem (CRC), ASCII and 
DC2/DC4 file transfers 

■ Totally configurable to 
your needs! 

■ S15 online time and CIS 
membership 

Ask your local telecom 
guru's opinion. FLASH is the 
winner. . . hands down! 
FLASH 
STD220 S39.95 

FLASH-CARDS TH9025 $7.95 



ILASH is to the Atari ST what Lotus 1-2-3 is to the IBM PC" 
—Ken Wolburn Microtimes Magazine 



DOUBLE THE 
POWER OF 
YOUR FLASH! 
TRANSFORM 
IT INTO A BBS! 
ADD KERMIT! 



REMOTE CONTROL 
ACCESSORY & KERMIT 
PROTOCOL" 

by Joe Chiazzese and 
Alan Page 

One mouse-click tranforms 
FLASH into a password- 
protected BBS. You can send 
and receive files while you're 
ul another room or even away 
from home! 
Plus, you can now use the 



powerful KERMIT protocol 
with FLASH. With KERMIT, 
you can transfer up to 128 
different files without 
touching your keyboard! 
More powerful than the 
version shipped with the Atari 
Developer's Kit— total 
automation for less than S25! 

Works with any Hayes- 
compatible modem. 
{Remote/Kermit requires FLASH") 
ST0226 $24.95 
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QUICKTRAN 

The Modem Accelerator 
Adrian Jovanovich 
Your 1200-baud modem can 
now transfer files at over 2000 
baud. . . 2400 baud now flies 
at 4000 baud. . . The tele- 
phone company can't stop 
you. It's totally legal! 
The Buddy System 
Ql'ICKTRAN comes to you as 
two identical disks. Each con- 
tains a desk accessory that 
works by itself (as a VT52 
emulator), or with FLASH. The 
QUICKTRAN accessory auto- 



matically shrinks a file when 
you're sending it — in real 
time, smaller than ARC.TTP. 
And on the receiving end, the 
file is expanded back into it's 
original size as it's coming in 
over the phone lines. 
Why spend hundreds of dol- 
lars on a faster modem when 
you can transfer files in almost 
half the time with QUICKTRAN? 
Get together with a friend and 
start a modem conspiracy! 
O.UICKTRAN 
ST0247 S34.95 
(2-disk set) 
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ARTIFICIAL INTELLIGENCE 
Teach your ST, then let it 
teach you! 

EXPERT OPINION" 

by Mind Soft 
Curious about expert 

systems and artificial 
intelligence? Discouraged 
because most expert systems 
tools are either for the IBM 
PC or Macintosh? And 
usually cost over S700? 

Transform your ST into 
an expert on any subject. 
EXPERT OPINION creates 
production-rule knowl- 
edge bases with more 
power than the average 
university system. And 
you don't need to know a 
programming language like 
Prolog or LISP— EXPERT 
OPINION is totally GEM- 
based. ..so you already 
know how it works. 

Create your own expert 



systems for classification 
of Horticulture, Animal 
Husbandry, Gemology, 
Medical diagnosis, 
Economics — any subject 
you want. Be a part of the 
first wave of knowledge 
engineers! 

EXPERT OPINION'S 
"Inference Engine" solves 
problems three ways: 
DEDUCTION (forward 
chaining); VERIFICATION 
OF A HYPOTHESIS (back 
ward chaining); or a unique 
combination of both 
modes CERTAINTY 
LEVELS allow you to fine- 
tune your knowledge base 
with heuristic control. 
Plus, the clear, well- 
written documentation 
includes a tutorial by 
Harvard expert and START 
contributing editor 
Christopher Chabris. 



.BATTERIES 




ANYTHING THIS MUCH FUN IS USUALLY ILLEGAL. 
D.E.G.A.S. ELITE" 

by Tom Hudson 

The best-selling graphics software on the Atari ST just got ten 
times better! D.E.G.A.S. ELITE has all the power of the 
original, plus: 

1) Multi-color fill patterns 

2) Special effects like scaling, perspective distort, rotating, 
outlining, and color animation 

3) Multiple screens in RAM at once (up to 8) — cut and 
paste between them 

4) Color search and replace 
DEGAS ELITE 
TH9036 $79.95 
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FREE BONUS! To get 

you started, we've 
included a disk packed 
with knowledge bases 
about a typical application 
. . . Gemology. The six 
linked knowledge bases 
will guide you through the 
classification of over eighty 
kinds of rocks and minerals. 



Perfect for studying how 
an expert system is built. 
EXPERT OPINION 
(Z-disk set) 

ST0219 $99.95 
WARNING: This is a 
sophisticated computer 
science tool requiring 
study to use it effectively. 




** 



INTEGRATED FINANCIAL 
SOFTWARE FROM 
BATTERIES INCLUDED 
THE lSGUR PORTFOLIO™ 

THE ISGUR PORTFOLIO is 

three programs in one: Port- 
folio manager, telecommuni- 
cations, and calendar/memo 
pad. Receive Dow Jones stock 
quotes, CompuServe, The 
Source, and InfoGlobe financial 
information, automatically. 
Consolidate multiple stock 
portfolios. Hands on manage- 
ment of stocks, bonds, options, 
commodities, mutual funds — 
your key to financial success. 

A real value for your invest- 
ment. Plus, THE ISGUR 
PORTFOLIO includes l*S 
TALK. Invest in your 
future . . . today, 
TH9G09 $199.95 

A SPELLING CHECKER THAT 
IS LIGHTNING FAST! 
THUNDER" 

THUNDER gives you a power- 
ful spelling checker accessible 
from within your favorite 
application program. Your 



accuracy will skyrocket, so 
the time spent proofing will 
plummet. 

It's so simple. Here's how 
it works. Example: you're 
happily writing away and you 
make a "mstake" and BEEP 
(THUNDER picks up the error 
with lightning-fast speed). 
Now THUNDER will display a 
list of similarly spelled words 
(stake, mistake, etc.). 
TH9011 $39.95 

TAKE A SECOND FOR 
TIME MANAGEMENT 
TIMEUNK'" 

TIMELINK is a great GEM- 
based scheduling and time- 
keeping tool for home and 
business. Your day, week, 
month and year appointments 
are only a mouse-click away. 
Useful for messages, 
reminders and much more. 
There are many incredible 
uses for this handy elegant, 
time-saving tool. 
TH9010 $49.95 



CREATE NEAR-SYNTHESIZER-QUALITY SOUND EFFECTS 
WITH OUR SOUND LABORATORY. 

G.I. Sound Tool 
G.I.S.T. M 

by Lee Actor & Gary Levenberg for Synthetic Software 
If sound has always fascinated you . . .or if you're a programmer 
or developer. ..take a look at G.I. S.T., the sound editor. G.I.S.T. 
was created to establish a standard of sound generation on the 
Atari ST that far surpasses the abilities of the built-in sound chip. 
G.I.S.T. is really 
two programs: 

1) GEM-based editor 

2) Sound Driver 
As you can see 

from the screen 
display, the G.I.S.T. 
editor gives you real- 
time mouse control 
over any sound 
shape. The key to 
G.I.S.T.'s power is dynamic control of the GI chip. Each voice 
has three ADSR (envelope) controls and three LFO's (low 
frequency oscillators). You'll be creating sounds like a profes- 



sional engineer— Near Synthesizer Quality (NSQ) sound. 

For programmers, the Sound Driver is linkable object code 
that can be used in your own software. Adding superior sound 
effects to any program . . , It's interrupt-driven, so it won't 
impact the speed of your software. In fact, it's already built into 
CYBERMATE for CAD-3D — just one of many useful applications. 
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LET'S-GET-TECHNICALBOX 

■ Volume ADSR to shape attack, decay, sustain, release 

■ Volume LFO for Tremoio effects and AM (Amplitude 
Modulation) 

■ Frequency ADSR— frequency shifts up to ± 3 octaves! 

■ Frequency LFO for Vibrato effects and FM (Frequency 
Modulation) 

■ LFO delay lets you add effects at any point in the sound 

■ MIDI-compatible! Use your keyboard to play the GI chip 

■ Three sound windows may be open at once 

G.I.S.T. is also compatible with CYBERMATE. Add sound 
effects to your CAD-3D animations! 



Source-compatible with Alcyon C, Megamax C, and Lattice C. 

G.I.S.T. 

ST0233 $34.95 




START ICON EDITOR HITS 


alone. He kept adding things. . 


. icon code generation so you 


■ Faster Paint and Line modes 


P.I.E." 0Jl 


Now, the Desktop Icon Edi- 


can now design icons for your 


■ New Image Cut & Paste 


or has graduated. RLE. is the 


own programs. And while he 


functions 


Professional Icon Editor 


Professional Icon Editor — for 


was at it, he added a bunch of 


■ Selectable Fill Patterns 


Alex Leavens 


programmers as well as desk- 


graphics improvements to de- 


■ Horizontal and Vertical Im- 


It began as a hot little desk ac- 


op artists. Alex has added 


light the artist in you. 


age Flip 


cessory in START, The ST 




New features include: 


■ Multiple Sub-function Menus 


Quarterly — you know, "Cus- 
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■ Nine-level Bi-directional 
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ages; RLE. can be used from 


Undo buffer 


was a lot of fun. You could 


within the Resource Construc- 


■ In-program Desktop Icon 


redesign your Trash can to 


tion Set to create and edit 


Preview mode 


look like a paper shredder. But 
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icons for the resources you're 


■ Improved Keyboard Response 


the programmer, Alex 
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currently working on! 


RLE. 


Leavens, just couldn't leave it 
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■ Improved Editing Features: 


ST0248 S29.95 







CRYSTAL" 

(It makes GEM shine...) 
by Jim Thompson 

These are the DOS Icons 
Digital Research forgot when 
they wrote GEM. It's too bad 
Atari didn't put CRYSTAL into 
the TOS ROM's, because for 
about 30K of code, CRYSTAL 
gives TOS the most powerful 
features of MS-DOS. Plus, you 
never lose the look and feel of 
GEM. And since CRYSTAL is a 
desk accessory, it's always 
available. 

In fact, these eight icons 
will eliminate all the frustration 



you feel from not having power- 
fid DOS functions available 
from within your favorite 
GEM program (or the desktop). . . 

Of course, CRYSTAL is 
compatible with all monitors, 
all disk drives, and all printers. 

Make your personal version 
of GEM shine— for S24.95. 
CRYSTAL 
ST0229 S24.95 



I he best utility buy 
of the year, without a 
doubt." 
—Current Notes 



ADD A WORLD OF DOS ICONS TO ALL OF 
YOUR GEM PROGRAMS. 



en 



RENAME files singly or 
batch 



CREATE and DELETE folders 



MOVE files In and nut of 
subdirectories or to other 
disks 

TEXT FILE FORMAT and 
PRINT using headers, 
footers, and page numbers 



COPY files 
FORMAT disks 



DISK LABELS printed 
3 automatically 
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The 20-track polyphonic MIDI recorder for the Atari ST. 
EZ-Track" 

This is the finest, moderately-priced MIDI software we've 
seen — and by an experienced firm with a strong music 
background. Easy to use, but no toy! With EZ-Track, you can 
make multitrack recordings in real time or step time, save them 
to disk, then play them back in perfect sync. Professional features 
include: Real-time solo and muting of tracks, quantizing (auto- 
correcting) of timing, instant transposition of entire song and 
much more. Memory capacity is over 27,000 notes on the 520ST 
and over 63,000 on the 1040ST— very flexible MIDI control. 
TH9029 $65.00 



The patch librarian, editor and sound generator for the CASIO 
CZ synthesizer series and Atari ST. 

CZ-AndrohT 

Completely professional MIDI software designed specifically for 
your CASIO CZ synthesizer. CZ-Android actually helps you 
program your CASIO CZ synthesizer. Then save thousands of 
your lush new patches with the 20,000-patches-per-disk 
librarian. Plus, you can edit all CZ parameters either 
graphically or numerically. The unique Android 
programmer lets you listen to thousands of new, original 
sounds and select the ones you like: to use right away, for 
graphical editing, or to save for later use. Get the most out of 
your instrument! 
TH9031 $99.95 



MIDI CABLES 

High-quality MIDI spec, cables in 5 foot length. 
TH9032 S3.95each 





MISSILE COMMAND™ MEETS SDI— WITH A TWIST. 
RED ALERT™ 

by Stanley Crane and Daniel Matejka 
What if you could view a game of SUPER MISSILE COMMAND 
from space? You'd be playing RED ALERT! Your cities are under 
attack. Russian ICBM's and MIRV's are coming in — both over 
the pole and from subs. You make the decisions about where to 
locate your Antiballistic Missile Silos, Ground-based Lasers, and 
when to use your space-based Particle Beam Weapon. The twist 
is that you may also place your cities anywhere you want . . . 
from your hometown to Havana. Or use the European scenario 
and defend London, Paris and Rome from the Red Menace! 
The perfect blend of strategy and arcade excitement. 
RED ALERT 
ST0223 S24.95 MISSILE COMMAND™ Atari Corp. 



WHY TRUST GYPSIES? 

STAR STRUCK" 
—The Astrologer 

by Harry Koons 
Sure, you can cross that palm 
with silver, but can you trust 
the results? Your ST. on the 
other hand, won't leave you 
in the gutter with empty 
pockets. And it's accurate! 
This GEM-based celestial 
workhorse instantly creates 
charts using formulas for the 
9 most popular historical 
house systems (Placidus, 
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Morinus, Porphory, and 
6 more). And if you don't 
know the coordinates of your 
birthplace, just point and 
click on the US or world 
maps! Of course, you can save 
charts in DEGAS format and 
create your own astro- 
masterpieces. STAR STRUCK 
works in color or monochrome 
and comes with loads of extra 
fonts. Now you've got some- 
thing to talk about at the local 
singles bar. 
STAR STRUCK 
ST0222 $24.95 



SAVE! 20 PERCENT OFF THE PRICE OF 
YOUR NEXT PURCHASE WITH ANY ORDER OF 
TWO OR MORE CATALOG EXCLUSIVES! (See 
THE CATALOG order form for details) 




800-443-0100, ext. 133 

(Continental U.S. and Hawaii) Visa/MC Only 

ORDER TOLL FREE 



AT LAST! subLOGIC 's Flight Simulator tor (he ST 
FLIGHT SIMULATOR II 

Buzz the World Trade Center— fly under the Golden Gate 
This is it. The Atari ST version of the phenomenally successful 
FLIGHT SIMULATOR II. And it's really something. 

Fly a Cessna prop plane, soar in a Lear jet, or dogfight with 
other planes in a World War 1 scenario. Completely mouse 
controlled! Multiple windows for multiple viewpoints: cockpit, 
spotter plane, tower, zoom-map — set up as many as you like, 
drag them, size them and put them where you want. Special 
custom-graphics routines permit multi-tasking windows. Explore 
accurate, solid, three-dimensional geographical scenarios which 
sweep by at update rates as high as 10 frames-per-second. Sup- 
plied scenarios include San Francisco, New York to Boston, 
Chicago to Champaign, Los Angeles, and Seattle 
RIVALS PROFESSIONAL TRAINING UNITS! 

Two experienced pilots on our staff took FLIGHT SIMULATOR 
II up for a spin and pronounced it a complete success — detailed, 
accurate, in many ways far better than professional flight simula- 
tors. You can preset your position and altitude and adjust your 
seasonal and weather conditions — including wind direction and 
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multiple cloud layers. Nine directonal views are available from 
the cockpit plus a zoom and a pan. "Instant Replay" feature lets 
you redo your most successful moments — which you can then 
watch from any vantage point! 

Spectacular two-player mode lets you fly with a friend over 
modem. If you know someone with an Amiga version, you can 
take your rivalry to the skies! 
FLIGHT SIMULATOR II 
TH9027 $49.95 
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SILENT SERVICE M 

Exciting World War II 
Submarine Action in 
the South Pacific! 
by Micro Prose 
0400 hours, Tuesday, 



STATIONS!! BATTLE 
STATIONS!! Enemy convoy 
identified on radar!! 

SILENT SERVICE, The Sub- 
marine Simulation, brings 
exciting action, great strategy, 



August 12, 1942 . . . BATTLE detailed graphics and an ultra- 



realistic simulation of World 
War II U.S. submarine action 
in the South Pacific. 

SILENT SERVICE'S out- 
standing features include: all 
the critical battle stations, 
engine room, conning tower 
and ship's bridge; challenging 
and realistic combat versus 
single ships and heavily 
escorted convoys; and an 
infinite variety of situations 
using complete maps and 
charts for the entire Southwest 
Pacific and a sophisticated and 
realistic attack plotting system. 

SILENT SERVICE provides 
a wide selection of historic 
scenarios. From hit-and-run 



attacks to patrol missions that 
bring challenge and fun to 
both the first time player and 
the experienced submarine 
veteran. 

As captain, you select a 
quiet patrol sector in the 
Marianas Islands, or choose 
the dangerous waters off the 
coast of Japan. Is the sub- 
merged daylight periscope 
attack best, or do you charge 
in on the surface at night 
using only radar bearings as 
your guide? These and many 
more decisions will determine 
your place among the elite 
ranks of the SILENT SERVICE. 
TH9D16 $39.95 



GET ORGANIZED AND HAVE 
FUN WITH MICHTRON 
Eliminate the desk battlefield 
and make organizing easy! 
CORNERMAN" 
What Sidekick did for the IBM, 
CORNERMAN does better for 
your Atari ST. This utility 
gives you a host of useful 
desk-top tools in one simple, 
neat package. With everything 
from a built-in clock, notepad, 
phone hook and ASCII table, 
to a full-function calculator, a 
cluttered desk is a thing of the 
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past. And as a desktop 
accessory, CORNERMAN is 
available nearly anywhere 
within GEM. 

CORNERMAN doesn't 
interfere with other programs 
and comes complete with 
security. HIRE THE PERFECT 
SECRETARY TODAY— HIRE 
CORNERMAN. 
(One megabyte RAM 
recommended.) 
TH9D13 $49.95 



PINBALL FACTORY" 

Design your own pinball 
machines! Full- featured editor 
includes graphics line, circle, 
ray, box, textured fill, and 
more. Use your mouse to drag 
bumpers, borders and bells 
into position. Adjust the 
gravity, elasticity and speed. 
Save your creations to disk 
and build a whole arcade of 
pinball wonders! 
TH9026 $39.95 



Now you're organized— 
so take a break and have 
some fun. 
TIME BANDIT" 

The arcade adventure takes 
you to the world of the 
biggest, fastest, most detailed 
game ever designed for a 
home computer. Features: 16 
unique arcade lands, 3,000 
screens, realistic detail, three 
text adventures, unique dual- 
player mode. Uses 16 color 
monitor. 
TH9014 $39.95 
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TURN YOUR ST INTO TWO COMPUTERS! 
K-SWITCH 1 " 

by Kuma Computers, Ltd. 

Picture this: You're in the middle of hyperwarp to an 
endangered sector of the Star Raiders™ galaxy when you hear 
the approaching footsteps of your boss. No problem. You press 
three keys and your ST instantly switches to 1ST WORD™ 
where you continue working on a letter to the Accounting 
Director. The boss's steps recede in the corridor. . .press three 
keys and — WHAMO! Right back in the middle of hyperwarp. 

If you have a megabyte of RAM in your ST you can now load 
two programs at the same time. K-SWITCH splits your ST 
into two isolated 400K blocks, with a shared RAMdisk. You can 



toggle between two programs instantly — at any time. The 
inactive program will be frozen in progress, ready to continue 
right where you left off. 

Now you can use your favorite word processor and database 
together. And for the ultimate in financial software, mate 
A-CALC PRIME and A-CHART, transferring data instantly with 
the RAMdisk. Even run low res. programs in one half, and 
medium res. in the other — it's a marvel to see it switch. 

If you own a megabyte ST, K-SWITCH will transform the way 
you use it. Today. 
(1 megabyte HAM required) 
K-SWITCH 
TH9023 $24.95 
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Construct GEM resources 

without spending $300 for the 

Atari Developers Kit. 

K-RESOURCE" 

by Kuma 

Do you program in any of 

these languages? ■ C, 

■ Pascal, ■ Modula2, 

■ Fortran, ■ Lisp. 

Now you can write 
professional GEM programs 
with custom icons and dialog 
boxes — without spending an 



arm and a leg. K-RESOURCE 
makes creating menus, icons, 
and screen dialogs easy. More 
powerful than the original DRI 
Resource Construction Set, 
K-RESOURCE is also compatible 
with all other .RSC files. 
K-RESOURCE 
TH9024 $49.95 



Here is the compiler that 
1ST WORD™ was written in. 

GSTC COMPILER" 

by GST, Ltd. 
If you've recently begun 
programming in C, this is the 
compiler you're looking for. 
Its GEM Superstructure 
Library™ will make your very 
first program run with GEM 
windows — automatically. 
Write GEM applications 
without the complex learning 
curve associated with GEM 
AESandVDl. Plus, you don't 
have to remember any arcane 
commands. The compiler and 
editor use GEM everywhere 
— it couldn't be easier! 

The package includes a spe- 
cial programmers version of 
the GEM-intuitive 1ST WORD™ 
editor, Linker, C Compiler, 68K 
Assembler, GEM bindings 
(including XBIOS) and a 
comprehensive user manual. 
GSTC 

TH9018 S79.95 
1ST WORD"" Alar Corp 
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A high-level Macro Assembler 
with an unbeatable combina- 
tion of price, performance, 
and features. 
GST-ASM" 
by GST, Ltd. 

When you want to squeeze 
that last drop of performance 
out of your ST, GST- ASM is the 
macro assembler that will get 
the job done. It's got every- 
thing. . . high-powered macro 
facilities and toolkit, extended 
macro functions, 100% 
Motorola compatibility, plus 
the built-in exclusive GEM 
editor and GEM "shell" oper- 
ating environment. In fact, it's 
probably the most elegant and 
sophisticated assembler avail- 
able for any microcomputer. 
Naturally, it also creates cross- 
reference listings, symbol 
tables, supports include files, 
generates relocatable code, 
and produces object files 
compatible with every high- 
level language. 
GST-ASM 
TH9017 S59.95 



A-RAM " by Kuma 

by Roddy Pratt, UK 
Can your RAMdisk partition 
any size disk emulator you 
want? 

■ A-RAM can. 

Can your RAMdisk accelerate 
your floppy write speed? 

■ A-RAM can. 

A RAMdisk is an area of 
memory set aside as a buffer 
that responds like a disk 



drive — only much faster. 
Everybody needs a great 
RAMdisk, and A-RAM is 

powerful, simple, and flexible 
enough for every application. 

BONUS! Order now and 
we'll send you the best print 
spooler you've ever seen. 
Never wait for your printer 
again! 

A-RAM & SPOOLER 
ST0215 $19.95 
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LEARN GRAPHICS PROGRAMMING WITH GSTC! 
GSTC APPLICATION/FOUNDATION I 
FRACTAL FACTORY" 

The best way to learn how to write a full-blown GEM 
application is by example. You need source code. FRACTAL 
FACTORY is a unique and beautiful program developed by the 
GST Ill-house programmers — and it's a great tutorial. It 
includes all the source code, batch files, linker files, graphics 
and math libraries — everything you need to build your own 
amazing ST program. Plus, FRACTAL FACTORY is the ultimate 
fractal-maker, using multiple windows, variable zoom, and 
contouring to display and save infinite generations of dazzling 
mathematical graphics. 
(Does not require GSTC.) 
FRACTAL FACTORY 
ST0228 $19.95 
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LATTICE C 

Here it is. The industry-standard C compiler for the IBM PC and 
Amiga is available now for your ST. 

■ Full Kernighan & Ritchie implementation 

■ Macros 

■ Complete interface to GEM libraries (al! libraries included in 
object and source form) 

■ Compatible with linkers for Alcyon (DRI) and GSTC 

■ Includes MENU+ GEM shell operating environment 

■ Full floating-point arithmetic 

■ No runtime licenses required 
" 270-page manual 

If you're writing serious software, you need a lot of 
flexibility. LATTICE C has it: PRE-PROCESSOR COMMANDS, 
STORAGE CLASSES, TYPE DECLARATORS, OBJECT 
MODIFIERS, INITIALIZERS, and STATEMENT TYPES. 

INCLUDES: EDITOR, LINKER, MENU+. 
Compatible with G.I.S.T. (page 10) 



LATTICE C 
TH0007 $149.95 



Technical questions? Talk 
with a Metacomco System 
Software Engineer: Call 
(408) 438-7201. 



MCC MACRO ASSEMBLER 

by Metacomco 

The MCC MACRO ASSEMBLER 

is the companion assembler 

for Lattice C and MCC Pascal. 

This full- specification 

assembler was specifically 

designed to complement those 

languages. Features include: 

linker, editor, GEM libraries, 

macros, MENU+ and 100-page 

manual. 

MACHO ASSEMBLER 

TH0005 $79.95 



FLOPPY DISKS AREN'T 
PERFECT. THAT'S WHY YOU 
NEED DISK DOCTOR. 
DISK DOCTOR" 

by Dan Matejka 
The best time to get a good 
firs'* efinor is before your 
un-backed-up disk is zapped 
by a power surge — or you 
mistakenly send your tax- 
return to the trash can 
instead of the backup disk in 
drive B. 



MCC PASCAL™ 

ISO PASCAL COMPILER 

A fast and powerful imple- 
mentation of ISO PASCAL 
conforming fully to the 
exacting ISO 7185 standard. 
MCC PASCAL is the ideal Pascal 
for new or experienced users. 
Features include: 

■ Fast, single-pass compilation 

■ Compatible with ISO Pascal 
running on other macros 

■ 32-bit integer math plus 
32-bit floatingpoint 

■ Comprehensive error- 
handling 

■ Includes MENU+ GEM shell 
operating environment 

■ 215-page manual 

INCLUDES: EDITOR, 
LINKER, MENU + . 
ISO PASCAL 
TH0006 $99.95 



DISK DOCTOR will make 
recovery of your lost data as 
painless as possible. You can 
even use its built-in GEM disk 
editor to personalize your 
own software's menus and 
error messages. DISK DOCTOR 
is the perfect file repair utility 
for casual users, plus it's one 
of a programmer's most 
valuable tools. 

DISK DOCTOR 
STD211 $29.95 



MAINFRAME ARTIFICIAL 
INTELLIGENCE ON AN ST? 
ABSOLUTELY! 
CAMBRIDGE LISP™ 68000 
LISP, the symbolic language of 
artificial intelligence appli- 
cations, is now available on 
the Atari ST. LISP (LISt 
Processing) is the language of 
choice in the fields of robotics, 
expert systems, and natural- 
language interfaces. 

CAMBRIDGE LISP 68000 
was created in the same 
A.I. lab that developed the 
original LISP. Its authors, 
Cambridge University Profes- 
sors John Fitch and Dr. Arthur 
Norman, have custom-designed 
a powerhouse, mainframe 



language for your ST that 
supports all GEM AES and 
VDI calls. 

Transform your Atari ST 
into a full A.I. workstation at 
the most outstanding price/ 
performance yet achieved by a 
LISP system on any personal 
computer. And CAMBRIDGE 
LISP 68000 is both an 
interpreter and a compiler. 
Use the interpretive mode 
together with the trace package 
to quickly develop and debug 
programs. When all the 
diagnostics check out — 
compile it! 

INCLUDES: EDITOR, 
LINKER, MENU+. 
CAMBRIDGE LISP 
TH9037 $199.95 



for an environment that's superb for development, 
I vote for Metacomco." 
—Anita Sinclair, 
Magnetic Scrolls, UK 

(developers of THE PAWN) 



WANTTOSELL YOUR ST SOFTWARE? 



HERE'S HOW: 

We market a wider range of software than anyone in the 
ST marketplace. Whether you're a first-timer, veteran, 
or a major software firm, we have a place for you in 
The Catalog. We also distribute thru over 1,000 retailers. 
So, if you're looking for broad distribution and under- 
standing support, send us your program and let us take a 
look. Worried about security? So are we. Just send us a 
description of your software and we'll arrange the 
necessary non- disclosure agreements. 
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Product Development Dept. 

544 Second Street 

San Francisco, CA 94107 

(415)957-0886 




800-443-0100, ext. 133 

(Continental U.S. and Hawaii) Visa/MC Only 

ORDER TOtt FREE 
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ST BASIC/ LOGO SAMPLER 

BASIC: Includes MIDIREC.BAS 
— a simple MIDI sequencer 
and sample song files, BG.BAS 
— backgammon. Fractals in 
BASIC, Biorythm's, and more. 
LOGO: Nearly a dozen useful 
routines including complex 
graphics. Plus two bonus desk 
accessories. 
PD9078 S12.00 

SOLID SOURCE CODE 

Features Jim Luczak's VDI 
SAMPLER and C PRIMER, 
which demonstrates C pro- 
gramming techniques and the 
use of VDI functions and their 
C BINDINGS. 
PD9079 $12.00 



XLISP 

XLisp, written by David Betz, 
is a version of the LISP pro- 
gramming language on the 
Common LISP standard with 
extensions for object-oriented 
programming. 
PD9084 $12.00 

PROFF 

PROFF is a text formatter 
similar to popular mini- 
computer tools like RUNOFF 
and TROFF. PROFF takes input 
from standard ASCII text files 
with embedded formatting 
commands and produces 
fully-formatted output files. 
PD9089 $12.00 



ST ARCHIVES 

START back issues and ANTIC compendiums 
GET YOUR ST LIBRARY OFF TO A GOOD START! Back issues of 
STAR!', the ST Quarterly, are now available. You can order either 
the magazine, or the START disk — or both. Be sure and get them 
all now while we still have them in stock. (Issue #1 is in very 
limited supply. If you want that one, don't linger.) Magazines are 
only S4.00 each, disks are S10.95 









MAGAZINE § 


DISK* 


START #1 


SUMMER 


'86 


SMS(&tt 


SDS0686 


START #2 


FALL 


'86 


aflMowi 


SDS0986 


START « 


WINTER 


'86 


SMS1286 


SDS1286 


START #4 


SPRING 


'87 


SMS0387 


SDS0387 



AND— THE ANTIC ST RESOURCE COMPENDIUM 

A complete collection on VA " disk of ail the programs appearing 
in the ST RESOURCE section of ANTIC Magazine from the very 
first issue. Each disk is packed with example source code and 
rimnable programs. S10.95 each. 



ST RESOURCE COMPENDIUM #1 
ST RESOURCE COMPENDIUM #2 
ST RESOURCE COMPENDIUM #3 
ST RESOURCE COMPENDIUM #4 



ISSUES DISK # 

8/85-1/86 SB0I0T 

2/86-5/86 SB0102 

6/86-9/86 SB0103 

10/86-2/87 SB0106 



ATTENTION RETAILERS! 

The Catalog offers retailers the highest quality software at 
the lowest price. We're eager to help you service the grow- 
ing community of ST owners in your area. Give us a call at 
(415) 957-0886 and ask for Brian Sarrazin, Sales Manager. 



ARChlve Collection 

A collection of tools for 

manipulating archives — 

multiple files combined and 

compressed into single library 

files for later extraction and 

use.. 

PD9094 $12.00 

S/Termlnal plus SOURCE! 

PD9057 $12.00 

"Enhanced version with fill 
and palette functions." 
ST DOODLE plus SOURCE 

PD9058 $12.00 

ST FRACTALS PIUS SOURCE! 

Uses Mandelbrot algorithm to 
draw fractals in GEM windows 
in any resolution. Then zoom 
in with2x, 4x, 8x, or l6x 
magnification. Change fractal 
iteration values and rescale 
fractals to enhance their color, 
PD9068 $12.00 

DEGAS COMPETITION 
HI-RES WINNERS 

The lop eight monochrome 
entries from Batteries 
Included's Mt^art 
competiSwrlncludes a slide- 
show viewing program — 
DEGAS is not required. 
PD9076 $12.00 

DEGAS COMPETITION 
COLOR WINNERS 

The top eight color entries 
from Batteries^MSuded's 
DEGAS agBWmipetition. 
Includes a slide-show viewing 
program— DEGAS is not 
required. 
PD9077 $12.00 

MIcroEMACS Collection 

MicroEMACS, originally 
developed by David Conroy, is 
a popular implementation of a 
useful subset of the EMACS 
text editor used on mini- 
computers 

$12.00 



UNITERM-TEK/DEC 
Terminal Emulators 

UNITERM, written by Simon 
Poole, is a public domain 
GEM-based terminal emulator 
supporting complete VT100 
and Tektronix 4010/4014 
modes (with zoom), as well as 
ASCII file-transfers and other 
features. Also included on the 
disk, both with full C source 
code, are WTERM II, a GEM- 
based Tektronix 4010 
emulator. 
PD9091 $12.00 

ADVSYS 

ADVSYS, written by David 
Betz, is a complete Lisp-like 
language for creating text 
adventure games. It offers 
special facilities for giving 
descriptions, parsing user- 
input sentences, and handling 
objects and actors. Includes 
complete docs on disk, as well 
as "Starship Columbus," a 
completely documented 
sample adventure that's also 
fun to play! 
PD9092 $12.00 

SPELL/Wrlter's Tools 

SPELL, written by Eric 
Bergman-Terell in Personal 
Pascal, is a simple spelling- 
checker for ASCII or lst-Word 
files. It scans your document, 
reporting incorrect words and 
allowing you to add them to 
the program's unlimited-size 
dictionary. 
PD9093 S12.00 

CAD-3D COLLECTION I 

The first collection of complex 
objects created by Tom Hudson 
with CAD-3D. 
{requires CAD-3D ST0214) 
S12.00 
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